Risuai

Risuai is a cross‑platform AI chat application with a rich feature set designed to run via Docker Compose. It supports multiple AI providers, such as OpenAI and other compatible backends, and offers capabilities such as emotion imagery, group chats, plugins, regex-based output manipulation, translation, lorebooks for memory, themes, and TTS. After starting the service with Docker Compose, you can access the web UI to interact with characters, manage memory, customize prompts, and configure providers and plugins. The deployment is described in the repository’s Docker setup, and the app exposes a web interface where you can create chats with multiple characters, enable memory features, and attach assets to chats. The system is designed to be web-first with a friendly UI, making it straightforward to experiment with different AI providers, memory modes, and prompting strategies in a single place.

Prerequisites:

• Docker and Docker Compose installed on your machine
• Git (optional, for cloning the repo)

Installation steps:

1. Ensure Docker is running on your system.

2. Use the Docker Compose method shown in the project README to start Risuai:

   curl -L https://raw.githubusercontent.com/kwaroran/Risuai/refs/heads/main/docker-compose.yml | docker compose -f - up -d

3. Open your browser and navigate to the deployment URL. If you followed the default Docker setup, the web UI will be accessible at http://localhost:6001. You can then configure providers, memories, themes, and other features through the UI.

Optional: If you prefer to run the containers manually, you can adapt the docker-compose.yml to your environment and run docker compose up -d in the directory containing the file.

Tips and notes:

• The Docker setup relies on a docker-compose.yml present in the repository; read it to understand service names, ports, and volumes.
• The default access URL is http://localhost:6001, but this may vary if you customize ports in docker-compose.yml or environment variables.
• If you encounter port conflicts, adjust the port mappings in the docker-compose file or set environment variables accordingly.
• The app supports multiple AI providers; check the providers list in the UI to enable/disable specific backends and supply API keys as needed.
• For long-running conversations, consider memory configurations (e.g., HypaMemory/SupaMemory options) to manage context windows.
• If using a remote Docker host, ensure the DOCKER_HOST environment variable is properly set and that the host accepts remote API connections securely.