麦麦bot,一款专注于 群组聊天 的赛博网友(比较专注)多平台智能体
 
 
Go to file
SengokuCola ccc9af57b8 ref:记忆检索不再基于问题,而是基于上下文;添加一些调试用配置 2026-01-12 19:05:07 +08:00
.devcontainer add extensions in devcontainer.json 2025-05-09 15:08:21 +09:00
.github fix: 修正 Docker 工作流中的 maim_message 克隆链接以及镜像tag问题 2025-12-10 09:55:53 +08:00
changelogs update:更新rm和cl 2026-01-11 19:31:56 +08:00
depends-data 更新README 2026-01-08 22:33:39 +08:00
docs-src remove:移除utils_small模型,统一使用tool_use模型,移除弃用的LLM_judge类型 2025-12-24 19:28:44 +08:00
log_viewer log:修改一些log 2025-09-25 19:07:35 +08:00
plugins feat:日志上线数量可更改 2025-12-31 00:07:55 +08:00
scripts feat:优化记忆检索和停止 2025-12-31 19:34:33 +08:00
src ref:记忆检索不再基于问题,而是基于上下文;添加一些调试用配置 2026-01-12 19:05:07 +08:00
template ref:记忆检索不再基于问题,而是基于上下文;添加一些调试用配置 2026-01-12 19:05:07 +08:00
webui/dist WebUI 446a2143e49afc495e93c1ad99cf59700ec43aee 2026-01-10 22:47:37 +08:00
.dockerignore test(docker): 分段构建 2025-11-07 09:03:33 +08:00
.gitattributes 更新 .gitattributes 文件,添加 webui/dist/** 为二进制文件 2025-11-21 18:39:39 +08:00
.gitignore Merge branch 'dev' into feat-lpmm知识库加强 2025-12-18 18:58:10 +08:00
.pre-commit-config.yaml 添加 .pre-commit-config.yaml (这并不会启用hook) 2025-03-13 14:14:56 +09:00
CODE_OF_CONDUCT.md fix: 移除邮件联系的注释 2025-12-03 09:16:54 +08:00
Dockerfile feat: 更新 Dockerfile,添加 git 安装步骤以支持插件安装 2025-11-19 19:54:15 +08:00
EULA.md docs: update EULA 2025-12-01 23:29:04 +08:00
LICENSE Create LICENSE 2025-02-28 00:49:47 +08:00
PRIVACY.md 更新EULA和隐私条款,增加第三方插件使用的责任说明和隐私处理条款 2025-07-10 20:29:40 +08:00
README.md update:更新rm和cl 2026-01-11 19:31:56 +08:00
bot.py fix:生成api没有开始时间戳 2025-12-22 23:27:50 +08:00
docker-compose.yml fix: 修复每日构建的分支问题,更新 docker-compose 配置 2025-12-08 15:11:24 +08:00
dummy config:增加两个配置项,梦起始时间和全局记忆 2025-12-04 19:59:57 +08:00
pyproject.toml 优化由于WebUI启动时端口占用导致异常退出没有提示的问题 2025-12-08 18:48:11 +08:00
requirements.txt feat: 更新 requirements.txt,添加 python-multipart 依赖 2025-11-29 13:13:25 +08:00
uv.lock 优化由于WebUI启动时端口占用导致异常退出没有提示的问题 2025-12-08 18:48:11 +08:00

README.md

麦麦 MaiBot MaiCore

Python Version License Status Contributors Forks Stars Ask DeepWiki


MaiBot Character

🎉 介绍

🍔 MaiCore 是一个基于大语言模型的可交互智能体

MaiBot 不仅仅是一个机器人,她致力于成为一个活跃在 QQ 群聊中的“生命体”。她不追求完美,但追求真实。

  • 💭 拟人构建:使用自然语言风格构建 Prompt回复贴近人类习惯。
  • 🎭 行为规划:懂得在合适的时间说话,使用合适的动作。
  • 🧠 表达学习:模仿群友的说话风格,学习黑话,不断进化。
  • 🔌 插件系统:提供强大的 API 和事件系统,无限扩展可能。
  • 💝 情感表达:拥有独立的情绪系统和表情包互动能力。

🚀 快速导航

🌟 演示视频  |  📦 快速入门  |  📃 核心文档  |  💬 加入社区



🔥 更新和安装

最新版本: v0.12.2 (📄 更新日志)

  • 下载: 前往 Release 页面下载最新版本
  • 启动器: Mailauncher (仅支持 MacOS, 早期开发中)
分支 说明
main 稳定发布版本 (推荐)
dev 🚧 开发测试版本 (不稳定)
classical 🛑 经典版本 (停止维护)

📚 部署教程

👉 🚀 最新版本部署教程
(注意MaiCore 新版本部署方式与旧版本不兼容)

[!WARNING]

  • ⚠️ 项目处于活跃开发阶段API 可能随时调整。
  • ⚠️ QQ 机器人存在风控风险,请谨慎使用。
  • ⚠️ AI 模型运行可能消耗较多 Token。

💬 讨论与社区

我们欢迎所有对 MaiBot 感兴趣的朋友加入!

类别 群组 说明
技术交流 麦麦脑电图 技术交流/答疑
技术交流 麦麦大脑磁共振 技术交流/答疑
技术交流 麦麦要当VTB 技术交流/答疑
闲聊吹水 麦麦之闲聊群 仅限闲聊,不答疑
插件开发 插件开发群 进阶开发与测试

📚 文档

[!NOTE] 部分内容可能更新不够及时,请注意版本对应。

🧩 衍生项目

  • MaiCraft: 让麦麦陪你玩 Minecraft (早期开发中)。
  • MoFox_Bot: 基于 MaiCore 0.10.0 的增强型 Fork更稳定更有趣。

💡 设计理念 (原始时代的火花)

千石可乐说:

  • 这个项目最初只是为了给牛牛 bot 添加一点额外的功能,但是功能越写越多,最后决定重写。其目的是为了创造一个活跃在 QQ 群聊的"生命体"。目的并不是为了写一个功能齐全的机器人,而是一个尽可能让人感知到真实的类人存在。
  • 程序的功能设计理念基于一个核心的原则:"最像而不是好"。
  • 如果人类真的需要一个 AI 来陪伴自己,并不是所有人都需要一个完美的,能解决所有问题的"helpful assistant",而是一个会犯错的,拥有自己感知和想法的"生命形式"。
  • 代码会保持开源和开放,但个人希望 MaiMbot 的运行时数据保持封闭,尽量避免以显式命令来对其进行控制和调试。我认为一个你无法完全掌控的个体才更能让你感觉到它的自主性,而视其成为一个对话机器。
  • SengokuCola纯编程外行,面向 cursor 编程,很多代码写得不好多多包涵已得到大脑升级。 Code is open, but the soul is yours.

🙋 贡献和致谢

欢迎参与贡献!请先阅读 贡献指南

🌟 贡献者

contributors

❤️ 特别致谢

  • 略nd: 🎨 为麦麦绘制精美人设。
  • NapCat: 🚀 现代化的基于 NTQQ 的 Bot 协议实现。

📊 仓库状态

Alt

Star 趋势

Star 趋势


📌 注意事项 & License

[!IMPORTANT] 使用前请阅读 用户协议 (EULA)隐私协议。AI 生成内容请仔细甄别。

License: GPL-3.0