$git clone https://github.com/kwaroran/RisuaiRisuai, or Risu for short, is a cross platform AI chatting software / web application with powerful features such as multiple API support, assets in the chat, regex functions and much more.
| 1 | # Risuai |
| 2 | |
| 3 | <picture> |
| 4 | <img alt="text" src="https://raw.githubusercontent.com/kwaroran/Risuai/refs/heads/main/public/logo_typo_small.avif" width="400"/> |
| 5 | </picture> |
| 6 | |
| 7 | [](https://svelte.dev/) [](https://www.typescriptlang.org/) [](https://tauri.app/) [](https://vite.dev/) [](https://tailwindcss.com/) |
| 8 | |
| 9 | Risuai, or Risu for short, is a cross platform AI chatting software / web application with powerful features such as multiple API support, assets in the chat, regex functions and much more. |
| 10 | |
| 11 | # Screenshots |
| 12 | |
| 13 | | Screenshot 1 | Screenshot 2 | |
| 14 | | :--------------------------: | :--------------------------: | |
| 15 | | ![Screenshot 1][screenshot1] | ![Screenshot 2][screenshot2] | |
| 16 | | ![Screenshot 3][screenshot3] | ![Screenshot 4][screenshot4] | |
| 17 | |
| 18 | [screenshot1]: https://github.com/kwaroran/Risuai/assets/116663078/cccb9b33-5dbd-47d7-9c85-61464790aafe |
| 19 | [screenshot2]: https://github.com/kwaroran/Risuai/assets/116663078/30d29f85-1380-4c73-9b82-1a40f2c5d2ea |
| 20 | [screenshot3]: https://github.com/kwaroran/Risuai/assets/116663078/faad0de5-56f3-4176-b38e-61c2d3a8698e |
| 21 | [screenshot4]: https://github.com/kwaroran/Risuai/assets/116663078/ef946882-2311-43e7-81e7-5ca2d484fa90 |
| 22 | |
| 23 | ## Features |
| 24 | |
| 25 | - **Multiple API Supports**: Supports OpenAI, Claude, Gemini, DeepInfra, Ooba, OpenRouter... and More! |
| 26 | - **Emotion Images**: Display the image of the current character, according to his/her expressions! |
| 27 | - **Group Chats**: Multiple characters in one chat. |
| 28 | - **Plugins**: Add your features and providers, and simply share. |
| 29 | - **Regex Script**: Modify model's output by regex, to make a custom GUI and others |
| 30 | - **Powerful Translators**: Automatically translate the input/output, so you can roleplay without knowing model's language. |
| 31 | - **Lorebook**: Also known as world infos or memory book, which can make character memorize more. |
| 32 | - **Themes**: Choose it from 3 themes, Classic, WaifuLike, WaifuCut. |
| 33 | - **Powerful Prompting**: Change the prompting order easily, Impersonate inside prompts, Use conditions, variables... and more! |
| 34 | - **Customizable, Friendly UI**: Great Accessibility and mobile friendly |
| 35 | - **TTS**: Use TTS to make the output text into voice. |
| 36 | - **Additional Assets**: Embed your images, audios and videos to bot, and make it display at chat or background! |
| 37 | - **Long-term Memory**: Advanced memory systems including HypaMemoryV2/V3 memory compression, SupaMemory for context management to maintain long-term conversation context. |
| 38 | - And More! |
| 39 | |
| 40 | You can get detailed information on https://github.com/kwaroran/Risuai/wiki (Work in Progress) |
| 41 | |
| 42 | ## Community |
| 43 | |
| 44 | - [Discord Server](https://discord.gg/JzP8tB9ZK8) |
| 45 | |
| 46 | ## Installation |
| 47 | |
| 48 | - [Risuai Website](https://risuai.net) (Recommended) |
| 49 | - [Github Releases](https://github.com/kwaroran/Risuai/releases) |
| 50 | |
| 51 | ### Development prerequisites |
| 52 | |
| 53 | - Node.js 20.19+ or 22.12+ |
| 54 | - pnpm |
| 55 | |
| 56 | ### Docker Installation |
| 57 | |
| 58 | You can also run Risuai using Docker. This method is particularly useful for web hosting. |
| 59 | |
| 60 | 1. Run the Docker container: |
| 61 | ``` |
| 62 | curl -L https://raw.githubusercontent.com/kwaroran/Risuai/refs/heads/main/docker-compose.yml | docker compose -f - up -d |
| 63 | ``` |
| 64 | |
| 65 | 2. Access Risuai at `http://localhost:6001` in your web browser. |