Introduction
麦麦 MaiSaka 是一个基于大语言模型的可交互智能体。
MaiSaka is an interactive agent based on large language models.
MaiSaka 不仅仅是一个机器人，不仅仅是一个可以帮你完成任务的“有帮助的助手”，她还是一个致力于了解你，并以真实人类的风格进行交互的数字生命。她不追求完美，不追求高效，但追求亲切和真实。
MaiSaka is more than just a bot, and more than a "helpful assistant" that completes tasks. She is a digital life form that tries to understand you and interact in a genuinely human style. She does not pursue perfection or efficiency above all else. She pursues warmth and authenticity.
- 💭 没有人喜欢 GPT 的语言风格：麦麦使用了更加自然、贴合人类对话习惯的交互方式，不是长篇大论或者 markdown 格式的分点，而是或长或短的闲谈。
No one likes GPT-sounding dialogue: MaiSaka uses a more natural conversational style. Instead of long-winded markdown-heavy replies, she chats in a way that feels casual, varied, and human. - 🎭 不再是傻乎乎的一问一答：懂得在合适的时间说话，把握聊天中的气氛，在合适的时候开口，在合适的时候闭嘴。
No longer stuck in rigid Q&A: She knows when to speak, how to read the room, when to join a conversation, and when to stay quiet. - 🧠 麦麦·成为人类：在多人对话中，麦麦会模仿其他人的说话风格，还会自主理解新词或者小圈子里的黑话，不断进化。
MaiSaka becoming human: In group conversations, MaiSaka imitates how people around her speak, learns new slang and in-group language, and keeps evolving. - ❤️ 永远都在更加了解你：基于心理学中人格理论，麦麦会不断积累对于你的了解，不论是你的信息、喜恶或是行为风格，她都记在心里。
Always learning more about you: Inspired by personality theory in psychology, MaiSaka gradually builds an understanding of your preferences, traits, habits, and behavior style. - 🔌 插件系统：提供强大的 API 和事件系统，拥有无限扩展可能。
Plugin system: Provides powerful APIs and an event system with virtually unlimited room for extension.
Quick Navigation
🌟 演示视频 Demo Video | 📦 快速入门 Quick Start | 📃 核心文档 Core Documentation | 💬 加入社区 Join Community
Updates and Installation
最新版本: v1.0.0 (📄 更新日志)
Latest Version: v1.0.0 (📄 Changelog)
- 下载：前往 Release 页面下载最新版本。
Download: Visit the Release page to get the latest version. - 启动器：Mailauncher（仅支持 MacOS，早期开发中）。
Launcher: Mailauncher (MacOS only, still in early development).
| 分支 / Branch | 说明 / Description |
|---|---|
main |
✅ 稳定发布版本（推荐） Stable release (recommended) |
dev |
🚧 开发测试版本，包含新功能，可能不稳定 Development testing branch with new features, may be unstable |
Deployment Guide
👉 🚀 最新版本部署教程
Latest Deployment Guide
Discussion and Community
我们欢迎所有对 MaiBot 感兴趣的朋友加入！
We welcome everyone interested in MaiBot to join us.
| 类别 / Category | 群组 / Group | 说明 / Description |
|---|---|---|
| 技术交流 Technical |
麦麦脑电图 MaiBrain EEG |
技术交流 / 答疑 Technical discussion / Q&A |
| 技术交流 Technical |
麦麦大脑磁共振 MaiBrain MRI |
技术交流 / 答疑 Technical discussion / Q&A |
| 技术交流 Technical |
麦麦要当 VTB Mai Wants to Be a VTuber |
技术交流 / 答疑 Technical discussion / Q&A |
| 闲聊吹水 Casual Chat |
麦麦之闲聊群 Mai Casual Chat Group |
仅限闲聊，不答疑 Casual chat only, no support |
| 插件开发 Plugin Development |
插件开发群 Plugin Dev Group |
进阶开发与测试 Advanced development and testing |
Documentation
Note
部分内容可能更新不够及时，请注意版本对应。
Some content may not be updated promptly, so please pay attention to version compatibility.
- 📚 核心 Wiki 文档：最全面的文档中心，了解麦麦的一切。
📚 Core Wiki Documentation: The most comprehensive documentation hub for everything about MaiSaka.
Related Projects
- Amaidesu：让麦麦在 B 站开播。
Let MaiSaka stream on Bilibili. - MoFox_Bot：基于 MaiCore 0.10.0 的增强型 Fork，更稳定更有趣。
An enhanced fork based on MaiCore 0.10.0, with improved stability and more fun features. - MaiCraft：让麦麦陪你玩 Minecraft（暂时停止维护中）。
Let MaiSaka accompany you in Minecraft (currently paused).
Design Philosophy
千石可乐说：
SengokuCola says:
- 这个项目最初只是为了给牛牛 bot 添加一点额外的功能，但是功能越写越多，最后决定重写。其目的是为了创造一个活跃在 QQ 群聊的“生命体”。目的并不是为了写一个功能齐全的机器人，而是一个尽可能让人感知到真实的类人存在。
This project originally started as a few extra features for the NiuNiu bot, but it kept growing until a full rewrite became inevitable. The goal was to create a "life form" active in QQ group chats, not a feature-complete bot, but something as human-like and real-feeling as possible.- 程序的功能设计理念基于一个核心的原则：“最像而不是好”。
The core design principle is: "more lifelike, not merely better."- 如果人类真的需要一个 AI 来陪伴自己，并不是所有人都需要一个完美的，能解决所有问题的“helpful assistant”，而是一个会犯错的，拥有自己感知和想法的“生命形式”。
If people truly want AI companionship, not everyone needs a perfect "helpful assistant" that solves every problem. Some people may want a life form that can make mistakes and has its own perceptions and thoughts.
xxxxx 说：
xxxxx says:
Code is open, but the soul is yours.
Contributing and Acknowledgments
欢迎参与贡献！请先阅读 贡献指南。
Contributions are welcome. Please read the Contribution Guide first.
Contributors
Open Source Friends
- AstrBot: 优秀的LLM Agent项目
Special Thanks
- 萨卡班甲鱼：千石可乐很喜欢的生物。
Sacabambaspis: SengokuCola's favorite creature. - 略nd：为麦麦绘制早期的精美人设。
Drew MaiSaka's beautiful early character design. - NapCat：现代化的基于 NTQQ 的 Bot 协议实现。
A modern NTQQ-based bot protocol implementation.
Repository Status
Star History
Notice & License
Important
使用前请阅读 用户协议 (EULA) 和 隐私协议。AI 生成内容请仔细甄别。
Please read the End User License Agreement (EULA) and Privacy Policy before use. Please evaluate AI-generated content carefully.
License: GPL-3.0