Risuai  by kwaroran

Cross-platform AI chatting software for LLM roleplaying

Created 3 years ago
1,423 stars

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

1 day ago

Responsiveness

1 week

Pull Requests (30d)
62
Issues (30d)
67
Star History
55 stars in the last 30 days

Explore Similar Projects

Starred by Sebastian Raschka Sebastian Raschka(Author of "Build a Large Language Model (From Scratch)"), Pawel Garbacki Pawel Garbacki(Cofounder of Fireworks AI), and
16 more.

chainlit by Chainlit

0.4%
12k
Framework for rapid conversational AI app development
Created 3 years ago
Updated 4 days ago
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

1.3%
31k
LLM chatbot/framework for multiple platforms
Created 3 years ago
Updated 10 hours ago
Feedback? Help us improve.