README.md
July 20, 2026 · View on GitHub
牛牛就是复读机——群友说什么牛牛就说什么。
喜欢牛牛,就给牛牛点个 ⭐ 吧!
✨ 特性
🚀 快速开始
Note
前置:Python 3.12+、PostgreSQL、可用的 OneBot v11 协议端(如 NapCat)。
# 获取代码
git clone https://github.com/PallasBot/Pallas-Bot.git
cd Pallas-Bot
# 安装依赖(推荐 uv)
pip install uv
uv sync
# 主配置(首次部署)
cp config/pallas.example.toml config/pallas.toml
# 编辑 [bootstrap]:监听、superusers、[bootstrap.postgres]
# 开始运行(单进程)
uv run pallas
浏览器打开 http://<主机>:8088/pallas/,使用启动日志中的口令登录。
更完整的上手说明见文档站 快速开始。
📖 文档
部署、配置、插件、迁移与排障见文档站;全网在线牛牛与社区概览见社区中心。
| 文档站 | |
| 快速开始 | |
| 社区中心 |
🧩 相关仓库
| 仓库 | 说明 |
|---|---|
| Pallas-Bot-Docs | 文档站源码 |
| Pallas-Bot-WebUI | 控制台前端 |
| Pallas-Bot-AI | AI 对话 / 唱歌 / TTS 服务 |
| Pallas-Bot-Community-Stats | 社区统计与语料中心服务 |
| community-plugin-index | 社区插件商店索引 |
💭 碎碎念
V3 走到后来,市面上那些 Bot 已经能接话、能记上下文、能把模型用得很顺;牛牛多半还是群里那台搞怪用的复读机,冷不丁冒出一句,把气氛带歪一点点。
![]()
群友喜欢她,也是喜欢牛牛的神鬼搞怪。可若只停在记语料、偶尔抛一句,在 LLM 已经走进日常的今天,再假装什么都没发生,其实也有点说不过去。
所以 V4 并不是想给牛牛硬套一张 AI 皮。接上模型,是这个时代绕不开的一步;不接的话,很多「对话」相关的期待,我们自己也接不住。可我仍想把复读放在前面——模型轻轻托一把就好,群友的话才是她真正的声音。这一块也才刚起步,接得还生,偶尔也会闹别扭,还不成熟;但不想让她变成随便哪都能见到的通用聊天壳。
V3 的内核已经有点撑不住了——配置散、约定乱、控制台和运行时也对不太齐,继续堆只会越来越累。于是 V4 把内核与扩展、配置与控制台重新理了一遍;文档站、WebUI、AI、社区统计、插件索引也各自成仓。生态才刚起了个头,后面怎么长,还盼着大家一起养。
一路走来,我更盼的是:维护的人更好配一点,写插件的人更好下手一点;群里那台复读机还在,只是脚下的地,终于更踏实了一些。
💻 开发与贡献
欢迎通过 Issues / PR 参与改进。参与前请阅读 贡献指南 与仓库根目录 AGENTS.md。
| 公开进展 / 里程碑 | |
| 贡献指南 | |
| Agent 约定 |
🤝 社区与支持
💬 QQ 群
| 开发者 |
|
| 拉牛牛 |
|
| 闲聊 |
|
| 社区中心 | |
| 在线部署 / 牛牛 |
|
💝 打赏
请作者喝杯咖啡吧(请备注牛牛项目,感谢你的支持 ✿✿ヽ(°▽°)ノ✿):
🙏 致谢
- MaiBot:学习与陪伴向聊天机器人项目
- gsuid_core:多 Bot 插件核心框架
- ArknightsGameData:明日方舟游戏数据;决斗干员表与知识库由远端同步其
zh_CN/gamedata - ArknightsGameResource:干员头像等资源;决斗 / 知识库头像由此拉取
- MaaAssistantArknights:明日方舟长草助手 MAA;本项目的远控能力基于其远程控制协议实现
- NoneBot2:跨平台 Python 异步聊天机器人框架
- jieba_next:基于 Rust 加速的现代中文分词库
- beanie:异步 Python MongoDB ODM
- NapCat:基于 NTQQ 的现代化 Bot 协议端
- zhenxun_bot:QQ 群聊机器人项目
- Amiya-bot:基于 AmiyaBot 框架的 QQ 聊天机器人
- CustomMarkdownImage:基于 Pillow 的可自定义 Markdown 渲染器
📈 数据与贡献者
感谢各位大佬!
📄 许可证
本项目采用 AGPL-3.0(GNU Affero General Public License v3.0)许可证。