KouriChat/KouriChat

KouriChat – A Chinese‑language LLM chatbot platform

What it is

• KouriChat is a Python‑based chatbot that connects a large‑language‑model (LLM) service (e.g., DeepSeek via the Kouri API or a user‑provided API key) to the OneBot messaging protocol. It is marketed as an “immersive role‑play” assistant that can run in group chats, keep persistent memory, and display expressive emoji‑style replies.

Key capabilities (as listed in the README)

• Immersive role‑play – supports character‑driven conversations, including group‑chat scenarios.
• Smart dialogue segmentation & emoticon generation – splits long replies and adds emotion‑filled stickers.
• Persistent memory – stores conversation history across sessions.
• Web UI – a visual interface for configuration and interaction.
• OneBot compatibility – works with OneBot v11 (both reverse and forward WebSocket modes).
• Standalone client – can be launched directly via python main.py.
• Version 1.5 rewrite – the current release is a complete refactor.

What’s still in progress

• Multi‑user handling, image recognition, and voice message support.

How to get started

1. Install – download the pre‑built wheel from the GitHub releases and the accompanying elixir core wheel, then install with uv tool install … (the README shows a Windows‑centric command).
2. Configure – run python main.py init to generate a kourichat.toml file. Fill in:
   • OneBot WebSocket settings (reverse/forward)
   • LLM API key (either the project‑hosted Kouri API or a DeepSeek key from SiliconFlow).
3. Run – start the OneBot gateway (openclaw-onebotv11.exe run) and then launch KouriChat with kourichat run (or python main.py run).

Typical use cases

• Community or fan groups that want a “virtual companion” that can stay in character.
• Role‑play servers on platforms that support OneBot (e.g., QQ groups).
• Personal assistants that retain memory of past interactions.

Limitations & cautions

• The project is intended for research/learning only; the README explicitly forbids illegal or unethical usage.
• All generated content is the LLM’s output and does not reflect the developers’ opinions.
• Currently Windows‑focused; deployment instructions rely on Windows executables.
• Some core features (multi‑user, image/voice handling) are still under development.

Community & support

• Multiple QQ groups (dozens of group numbers are listed) and a QQ channel for “talking with AI”.
• Official website, Bilibili channel, Xiaohongshu page, and a Wiki for documentation.
• Direct contact via WeChat/QQ numbers and a business email for collaborations.
• Funding can be sent via QR code; the README mentions a “mystery sponsorship plan” for donors.

Bottom line KouriChat is a Chinese‑language chatbot framework that ties LLM APIs to the OneBot messaging ecosystem, offering role‑play‑oriented features and a web UI. It is a real, runnable software project aimed at hobbyists and community groups rather than a generic AI‑learning resource. The README provides clear (though Windows‑centric) setup steps, a list of current features, and a roadmap for upcoming capabilities.