Maibot
MaiSaka, an LLM-based intelligent agent, is a digital lifeform devoted to understanding you and interacting in the style of a real human. She does not pursue perfection, nor does she seek efficiency; instead, she values warmth, authenticity, and genuine connection.
Last verified:
What is Maibot?
MaiBot is an open-source AI chatbot designed specifically for group chat environments like QQ groups, providing a highly human-like interaction experience. Built on a multi-LLM collaboration architecture, it combines natural language understanding and generation capabilities with biomimetic thinking and planning to create natural, warm conversations that feel like chatting with a real person.
The bot features a sophisticated memory system called Hippocampus that uses graph-structured storage to remember conversations, user interests, and habits, allowing it to naturally reference past interactions. It includes a 2D emotional model based on valence and arousal that supports 19 emotional states,影响着打字速度和回复行为。MaiBot also has dynamic personality evolution that adapts to user communication styles over time.
Key features include natural conversation style with context-aware replies, emotion perception and expression, support for emojis and sticker images in QQ, automatic learning of group-specific slang and memes, MCP tools integration for real-time information like stock prices, and multiple deployment options including Docker, Windows, Linux, and macOS. The bot uses a behavioral planning module to decide when to reply based on context, group activity, and appropriateness.
MaiBot is designed for QQ group administrators, community managers, developers who want to build custom plugins, and anyone seeking a human-like virtual companion rather than a perfect tool. It's built with Python, uses modular design with core components including chat controller, memory manager, emotion expresser, personality configurator, and plugin system. The project uses GPL-3.0 license and welcomes community contributions.
Maibot pricing
Pricing model: Freemium
MaiBot itself is completely free and open-source under GPL-3.0 license. However, it requires an AI model API key from external providers. Options include: Alibaba Cloud Bailian (Qwen) - low cost, pre-integrated with full Qwen series; SiliconFlow - low cost, 200+ models with one API key; DeepSeek - very low cost, best price-performance ratio with top-tier reasoning; Zhipu AI (GLM) - free tier with Flash series permanently free plus 20M free tokens for new users, text/vision/embedding fully supported; Kimi (Moonshot) - medium cost with 262K context window. Most providers offer free trial credits for testing.
Maibot pros
- Open-source with GPL-3.0 license for free use and modification
- Multi-LLM collaboration for natural dialogue understanding and generation
- Sophisticated Hippocampus memory system with graph-structured storage
- 2D emotional model with 19 emotional states affecting responses
- Human-like interaction design that makes mistakes and learns like humans
- Supports multiple deployment methods: Docker, Windows, Linux, macOS
- WebUI configuration interface for non-technical users
- Behavioral planning module decides appropriate reply timing
- Automatic learning of group-specific slang and memes
- Supports emojis and sticker images in QQ group chats
- MCP tools integration for real-time stock prices and data
- Dynamic personality evolution adapting to user communication style
- Hot-reloading configuration support without restart
- Multiple AI provider options including free tier (Zhipu GLM)
- Plugin system with API and event interfaces for extensions
- Pre-configured Chinese mirror (Tsinghua) for faster dependency installation
- Context-aware reply mechanism avoiding mechanical responses
- Memory compression and sampling to control quality and quantity
Maibot cons
- Requires QQ side account (main accounts risk being restricted)
- Requires Python 3.10+ installation and configuration
- Needs API key from external AI provider (not completely free)
- NapCat adapter must be manually enabled after installation
- Plugins are disabled by default requiring manual activation
- Initial setup requires multiple steps including Git, uv, dependencies
- Bot may exit immediately if API key not configured correctly
- Port conflicts can prevent WebUI from starting on default 8001
- Primary focus on QQ limits use to Chinese social platform
- Requires interactive terminal for EULA acceptance on first launch
Frequently asked questions about Maibot
What is MaiBot and what makes it different from other chatbots?
MaiBot is an open-source intelligent chatbot focused on providing human-like interaction experience for group chats like QQ. Unlike functional robots, MaiBot is designed as a virtual partner that makes mistakes, learns, and grows. It features multi-LLM collaboration, biomimetic thinking architecture, a sophisticated memory system that remembers conversations and user interests, a 2D emotional model with 19 emotional states, and dynamic personality evolution that adapts to user communication styles.
What AI model providers can I use with MaiBot?
MaiBot supports multiple AI providers: Alibaba Cloud Bailian (Qwen) as default with low cost and stable access in China; SiliconFlow with 200+ aggregated models; DeepSeek with very low cost and best price-performance ratio; Zhipu AI (GLM) with free Flash series and 20M welcome tokens; Kimi (Moonshot) with 262K context window. You need to get an API key from your chosen provider.
Do I need to be a programmer to use MaiBot?
No, you don't need programming experience. MaiBot provides a friendly WebUI configuration interface at http://127.127.0.1:8001 for non-technical users. The setup wizard guides first-time users through configuration. You can change nickname, personality, chat frequency, and models through WebUI's Config Management page without manually editing files. Most changes apply instantly with hot-reloading support.
How does MaiBot's memory system work?
MaiBot has the most complex memory system with Hippocampus memory system using graph-structured storage. It supports memory building, forgetting, and integration with multi-layer depth search (1-3 layers) for direct and indirect related memories. There's also a working memory system for short-term chat focus with memory activation management. Memory configuration parameters include build interval, forget time, compression rate, and disabled word lists.
What deployment options are available for MaiBot?
MaiBot supports multiple deployment methods: Docker for containerized deployment, Windows with downloadable ZIP for beginners, Linux for server environments, and macOS. It uses Python 3.10+ (3.12/3.13 recommended) with uv package manager. The bot can run on servers with headless environments using environment variables to skip EULA prompts.
How do I connect MaiBot to QQ?
After MaiBot core starts, connect it to QQ using NapCat. Install NapCat following the official installation guide and log in with your QQ side account. Then in MaiBot WebUI, go to Plugin Management, search for NapCat Adapter, and install it. Important: plugins are disabled by default, so you must manually toggle the enable switch in Plugin Management or edit plugins/MaiBot-Napcat-Adapter/config.toml to set enabled to true.
What emotional capabilities does MaiBot have?
MaiBot has a 2D emotional model based on valence and arousal in a 2D emotional space, supporting 19 specific emotional states like happiness, anger, sadness. Emotional states affect typing speed and reply behavior. The system includes emotion decay mechanism where emotions naturally decay over time, emotion history tracking for trend analysis, and integration with personality system affecting relationship management.
How does MaiBot decide whether to reply to messages?
MaiBot uses a behavioral planning module that dynamically decides reply timing based on time, context, and group activity. It definitely replies when you @ the bot, speak directly to it, or when it feels you're asking something. It might reply when group chat is lively with good atmosphere, topics it's interested in, or when it has useful information. It usually won't reply when group is discussing private matters, atmosphere is serious/tense, or it feels inappropriate to join.
Can I extend MaiBot's functionality with plugins?
Yes, MaiBot has a plugin system with rich API and event interfaces for developers to extend functionality. You can develop custom plugins using the plugin development guide (v0.2 for 0.8.x), create adapters, and add custom skills. Plugins are installed via WebUI Plugin Management or manually cloned to plugins/ directory. The GitHub repository welcomes contributions through Pull Requests for core improvements or new features.
What license does MaiBot use and can I modify it?
MaiBot uses GPL-3.0 license, making it completely open-source. You can freely modify the code, submit issues and suggestions on GitHub, contribute code through Pull Requests, develop plugins using the plugin system, and customize personality through configuration files to adjust MaiBot's性格 and tone to create your own unique partner. The project welcomes every user and developer to participate.