RisuAI  by kwaroran

Cross-platform AI chatting software for LLM roleplaying

Created 2 years ago
1,171 stars

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

2 days ago

Responsiveness

1 week

Pull Requests (30d)
11
Issues (30d)
4
Star History
36 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.