MaiBot MaiCore

A cyber friend multi-platform agent focused on group chat, built on large language models with core capabilities in human-like expression, behavioral planning, and emotional interaction.

One-Minute Overview#

MaiBot is a cyber friend multi-platform agent focused on group chat scenarios. Built on large language models, it simulates human expression patterns and behaviors, creating natural and engaging interactive experiences in group environments.

Core Value: Creates life-like chat experiences rather than mechanical assistants, making group interactions more interesting and human-like.

Quick Start#

Installation Difficulty: Medium - Requires Docker environment, Python 3.10+, QQ Bot protocol (NapCat), and LLM API access

# Clone the project
git clone https://github.com/Mai-with-u/MaiBot.git
cd MaiBot

# Run with Docker
docker-compose up -d

Is this suitable for me?

✅ Group Chat Interaction: QQ groups and other social platforms' group chat scenarios

✅ Human-like Interaction: Scenarios requiring simulated human speech patterns and emotional expression

❌ Task-oriented Use Cases: Not designed as a traditional task assistant

❌ High Customization Needs: Beginners may find deep customization challenging

Core Capabilities#

1. Human-like Construction - Natural Expression#

Uses natural language style prompts for responses that mimic human speech habits User Value: Makes bot responses more natural and fluid, reducing the AI feel and enhancing chat experience

2. Behavioral Planning - Appropriate Timing#

Intelligently determines appropriate timing and actions for responses User Value: Prevents the bot from over-posting or interrupting conversations at inappropriate times, creating better group chat atmosphere

3. Expression Learning - Adaptation and Growth#

Learns group members' speech patterns and slang to gradually integrate into specific group environments User Value: The bot improves its adaptation to the group environment over time, becoming more like a "member" of the group

4. Plugin System - Extensibility#

Provides powerful API and event systems for custom functionality User Value: Users can develop custom plugins to extend the bot's capabilities for specific scenario needs

5. Emotional Expression - Emotions and Interaction#

Built-in emotional system with emoji interaction support User Value: The bot can express emotions and increase interaction interest and emotional resonance through emojis

Tech Stack & Integration#

Development Language: Python 3.10+ Key Dependencies: NapCat (QQ Bot protocol), LLM integrations (e.g., DeepSeek) Integration Method: Multi-platform agent framework supporting QQ platform

Ecosystem & Extensions#

Plugins/Extensions: Provides complete event system and API for third-party development
Integration Capabilities: Supports multiple LLM API integrations, customizable through configuration files

Maintenance Status#

Development Activity: Actively maintained with multiple commits per week
Recent Updates: Recently released v0.12.2 (January 11, 2026)
Community Response: Active technical communication groups and plugin development groups with timely issue responses

Commercial & Licensing#

License: GPL-3.0

✅ Commercial Use: Allowed, but must comply with GPL-3.0 terms
✅ Modification: Code modification is allowed
⚠️ Restrictions: Modified code must be open-sourced, original copyright information must be included

Documentation & Learning Resources#

Documentation Quality: Comprehensive
Official Documentation: https://docs.mai-mai.org/
Example Code: Available with sample code and deployment tutorials