Risuai  by kwaroran

Cross-platform AI chatting software for LLM roleplaying

Created 2 years ago
1,293 stars

Top 30.7% on SourcePulse

GitHubView on GitHub
Project Summary

RisuAI is a user-friendly, cross-platform AI chatting application designed for LLM roleplaying, enabling users to create their own interactive stories. It supports multiple LLM APIs, advanced chat features like emotion images and group chats, and extensive customization options for prompts and character memory.

How It Works

RisuAI leverages a modular architecture to support various LLM APIs (OpenAI, Claude, Ooba, OpenRouter, etc.), offering flexibility in backend model selection. Its core functionality revolves around enhancing the roleplaying experience through features like emotion-synced character images, a lorebook for persistent character memory, and regex scripting for output manipulation. The application also includes integrated TTS and the ability to embed multimedia assets directly into the chat interface.

Quick Start & Requirements

  • Install: Recommended via Docker: git clone https://github.com/kwaroran/RisuAI.git && cd RisuAI && docker-compose up -d
  • Access: http://localhost:6001
  • Prerequisites: Docker.
  • Resources: No specific hardware requirements mentioned beyond Docker.
  • Docs: https://github.com/kwaroran/RisuAI/wiki (Work in Progress)

Highlighted Details

  • Multiple API support for LLMs.
  • Emotion images synchronized with character expressions.
  • Regex scripting for output modification.
  • Lorebook for enhanced character memory.
  • Plugin system for extensibility.
  • TTS integration for voice output.

Maintenance & Community

Licensing & Compatibility

  • License: Not explicitly stated in the README.
  • Compatibility: Cross-platform (Windows, macOS, Linux implied by "cross platform"). Docker support aids web hosting.

Limitations & Caveats

The official wiki and detailed documentation are still in progress, which may limit advanced configuration or troubleshooting. The license is not specified, potentially impacting commercial use or integration into closed-source projects.

Health Check
Last Commit

3 days ago

Responsiveness

1 week

Pull Requests (30d)
127
Issues (30d)
11
Star History
54 stars in the last 30 days

Explore Similar Projects

Starred by Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems") and Yaowei Zheng Yaowei Zheng(Author of LLaMA-Factory).

AstrBot by AstrBotDevs

0.8%
15k
LLM chatbot/framework for multiple platforms
Created 3 years ago
Updated 2 days ago
Feedback? Help us improve.