KouriChat is an AI-powered WeChat chatbot designed for realistic emotional companionship and role-playing. It targets users seeking an interactive AI assistant that can engage in natural conversations, generate images, and remember past interactions, all through the familiar WeChat platform.

How It Works

The system leverages Python and the wxauto framework for WeChat automation, enabling seamless integration with personal or bot accounts. It connects to Large Language Models (LLMs) like DeepSeek via API for conversational capabilities, supporting features such as role-playing, image generation/recognition, and voice message interaction. A Flask-based web UI facilitates configuration and management.

Quick Start & Requirements

• Install: pip install -r requirements.txt
• Run: python run.py or run.bat
• Prerequisites: A WeChat account (loginable on PC), an auxiliary device/emulator for WeChat PC login, and API keys for LLM services (e.g., DeepSeek).
• Setup: Requires configuration via run_config_web.py or editing src/config/config.json.
• Docs: https://kourichat.com/docs_0411/

Highlighted Details

• WeChat integration for multi-user and group chats.
• Immersive role-playing with configurable personalities.
• Image generation and recognition capabilities.
• Persistent memory for conversation history.

Maintenance & Community

• Active development with frequent updates (last updated March 25, 2025).
• Community support via QQ groups (multiple groups available, some full).
• Contact email: yangchenglin2004@foxmail.com.

Licensing & Compatibility

• The README does not explicitly state a license.
• Use is restricted to technical research and educational purposes; illegal or unethical use is prohibited.

Limitations & Caveats

The project requires a separate WeChat account capable of PC login, which may necessitate an auxiliary device or emulator. API keys for LLM services are mandatory, and users are responsible for their usage costs and adherence to terms of service.