RisuAI  by kwaroran

Cross-platform AI chatting software for LLM roleplaying

created 2 years ago
1,102 stars

Top 35.3% 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

8 hours ago

Responsiveness

1 week

Pull Requests (30d)
44
Issues (30d)
3
Star History
98 stars in the last 90 days

Explore Similar Projects

Starred by Chip Huyen Chip Huyen(Author of AI Engineering, Designing Machine Learning Systems), Andre Zayarni Andre Zayarni(Cofounder of Qdrant), and
2 more.

RealChar by Shaunwei

0.1%
6k
Real-time AI character/companion creation and interaction codebase
created 2 years ago
updated 1 year ago
Starred by Chip Huyen Chip Huyen(Author of AI Engineering, Designing Machine Learning Systems), Pietro Schirano Pietro Schirano(Founder of MagicPath), and
1 more.

SillyTavern by SillyTavern

1.5%
17k
LLM frontend for power users
created 2 years ago
updated 15 hours ago
Feedback? Help us improve.