BruceSun
/
MaiBot
mirror of https://github.com/Mai-with-u/MaiBot.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
麦麦bot，一款专注于 群组聊天 的赛博网友（比较专注）多平台智能体
5,072 Commits
5 Branches
29 Tags
70 MiB
Python 99.3%
Shell 0.7%
 
 
Go to file
墨梓柒 a9187dc312
feat: 添加log_viewer到.gitignore 		2026-01-13 06:18:27 +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
plugins feat：日志上线数量可更改 2025-12-31 00:07:55 +08:00
scripts feat：添加lpmm内部接口，信息抽取类和一个测试脚本 2026-01-13 00:47:55 +08:00
src Merge branch 'dev' of https://github.com/Mai-with-u/MaiBot into dev 2026-01-13 00:47:58 +08:00
template feat: 添加段落内容加载功能及相关配置 2026-01-13 00:42:49 +08:00
webui/dist WebUI b2a259fbc4c8477f2ab01eb5e7a75969cda53a1e 2026-01-13 00:43:55 +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 feat: 添加log_viewer到.gitignore 2026-01-13 06:18:27 +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