今天项目终于跑起来了，差点被配置劝退。
01 基于 LLM 的交互式智能体 · GPL-3.0
在群聊的喧嚣中，
遇见一个真正记得你的人。
MaiBot 不是冰冷的问答机器。它像一位老友，懂得对话的节奏，记得你提过的小事，会在恰当的时刻接上一句梗。它不是工具，是群聊里那个会心的存在。
Code is open, but the soul is yours.
为个人开发者、群聊、社区和陪伴场景而生。
A‑Memorix
记得你说过的话
在场感
知道什么时候开口
晚间摸鱼群
MaiBot 正在听
live
那挺好，环境变量那块确实烦。
它居然还记得上次的事。
02 A day in the chat
它在群里的一天。
从清晨的第一句问候，到深夜的最后一句道别。MaiBot 始终在场，却从不打扰。
-
09:42 ☀️ 清晨林
早，周一了。
麦周一。
-
14:17 🔧 午后陈
这个报错卡一上午了。
麦哪行，发来看看。
-
19:30 🌆 傍晚许
今晚有人上线吗。
麦在，刚吃完。
-
23:05 🌙 深夜林
散了吧。
麦嗯，早点睡。
03 互动小游戏
戳一戳麦麦。
点击麦麦的脸，看看它会有什么反应。每次点击都有惊喜。
点击次数：
0
试试连续快速点击
03 What it does
它会的事。
不是功能的堆砌，而是让每一次对话都自然流畅的默契。
接得住梗
它在学习你们的语言。群里的黑话、表情包、内部玩笑，都在它的记忆库里慢慢发酵。回复不再是模板，而是带着你们群独有的味道。
记得住人
长期记忆不是数据库查询，是朋友间的默契。它记得你提过的偏好、你们的关系、共同经历过的瞬间。下次聊天，它不会忘记。
看得懂气氛
它懂得什么时候该插话，什么时候该沉默。不是机械的"检测到关键词就回复"，而是像真人一样感知对话的温度和节奏。
接得上工具
插件、事件、MCP 工具——它不只是聊天。连接接口、读取文件、操控浏览器、自动化流程，让对话变成真正的行动。
带表情包
文字之外，还有表情和情绪。它懂得用更贴近日常聊天的方式表达，让对话不再干巴巴。
04 A-Memorix
记忆不是数据库，是朋友间的默契。
A-Memorix 记忆引擎构建知识图谱、对话摘要和人物画像，让麦麦持续积累对你的了解。不是冷冰冰的数据存储，而是像老友一样记得你提过的小事。
你
喜欢猫
程序员
熬夜党
上周聊过 Docker
昨天吐槽周一
知识图谱自动关联，每次对话都在丰富你的画像。
05 表达与黑话学习
越用越像你们。
自动从对话中提取表达风格和群体黑话，通过 LLM 推断含义并逐步完善。群里的内部梗、表情包、缩写，都在它的学习库里慢慢发酵。
群里说
"这波操作太秀了"
→
麦学会
用"秀"形容厉害的操作
群里说
"yyds"
→
麦学会
永远的神 = 最棒的
不是硬编码的词典，是从真实对话中生长的语言库。
06 Run it
跑起来。
三种方式，从极客到新手，总有一条适合你。
源码安装
适合喜欢掌控每一行代码的开发者。需要 Python 3.12+、Git 和 uv。第一次启动需要终端输入"同意"确认用户协议。
git clone https://github.com/Mai-with-u/MaiBot.git
cd MaiBot && uv sync
uv run python bot.py
WebUI 默认 http://127.0.0.1:8001
Docker 部署
最省心的方式。一条命令同时启动 MaiBot 核心、NapCat QQ 连接器、sqlite-web 数据库工具。自带环境隔离，适合快速上手。
git clone https://github.com/Mai-with-u/MaiBot.git
cd MaiBot
docker compose up -d
WebUI : 18001 · NapCat : 6099 · sqlite-web : 8120
一键包
为新手和 Windows 用户准备的预打包版本。无需配置环境，下载解压即可运行。目前可通过官方 QQ 群获取测试版本。
下载 → 解压 → 运行
三步搞定
QQ群：766798517 / 571780722
05 Under the hood
给开发者的。
不只是黑盒，而是可以拆解、理解、改造的开放系统。
Runner / Worker双进程架构，能监督、能重启。主进程挂了，Worker 自动拉起；Worker 卡了，Runner 强制重启。稳定不是靠运气，是靠设计。
MainSystem配置热重载、插件运行时、聊天管理和消息 API。改配置不用重启，加插件不用改源码，发消息有统一接口。开发者友好不是口号。
Unified tools插件、内置、旧版动作和 MCP 工具统一接进来。不管你的工具是什么格式，都能用同一套协议调用。扩展性不是堆功能，是统一抽象。
AdaptersQQ / NapCat 常用，也能扩到 Discord、Telegram。适配器模式让平台接入变成插件，而不是硬编码。想接新平台？写个 Adapter 就行。