README.md

July 20, 2026 · View on GitHub

Pallas-Bot

Pallas-Bot

「我是来自米诺斯的祭司帕拉斯,会在罗德岛休息一段时间......虽然这么说,我渴望以美酒和戏剧被招待,更渴望走向战场。」

报告 Bug · 提出新特性

license python nonebot2 stars

learning-repeater community-bots

tencent-qq tencent-qq

牛牛就是复读机——群友说什么牛牛就说什么。

喜欢牛牛,就给牛牛点个 吧!

✨ 特性

  • 学习型复读:记住群友说话,在合适时机复读出来
  • 复读优先:可选接入 LLM 辅助,回复仍以群友语料为主
  • 插件化:内置插件与本地扩展,按需启用
  • WebUI 控制台:浏览器管理配置、插件与权限
  • 可选能力AI 对话 唱歌 TTS MAA 远控

🚀 快速开始

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/,使用启动日志中的口令登录。
更完整的上手说明见文档站 快速开始

📖 文档

部署、配置、插件、迁移与排障见文档站;全网在线牛牛与社区概览见社区中心。

文档站 docs on GitHub Pages
快速开始 quickstart
社区中心 Pallas 社区中心

🧩 相关仓库

仓库说明
Pallas-Bot-Docs文档站源码
Pallas-Bot-WebUI控制台前端
Pallas-Bot-AIAI 对话 / 唱歌 / TTS 服务
Pallas-Bot-Community-Stats社区统计与语料中心服务
community-plugin-index社区插件商店索引
💭 碎碎念

V3 走到后来,市面上那些 Bot 已经能接话、能记上下文、能把模型用得很顺;牛牛多半还是群里那台搞怪用的复读机,冷不丁冒出一句,把气氛带歪一点点。

牛牛复读

群友喜欢她,也是喜欢牛牛的神鬼搞怪。可若只停在记语料、偶尔抛一句,在 LLM 已经走进日常的今天,再假装什么都没发生,其实也有点说不过去。

所以 V4 并不是想给牛牛硬套一张 AI 皮。接上模型,是这个时代绕不开的一步;不接的话,很多「对话」相关的期待,我们自己也接不住。可我仍想把复读放在前面——模型轻轻托一把就好,群友的话才是她真正的声音。这一块也才刚起步,接得还生,偶尔也会闹别扭,还不成熟;但不想让她变成随便哪都能见到的通用聊天壳。

V3 的内核已经有点撑不住了——配置散、约定乱、控制台和运行时也对不太齐,继续堆只会越来越累。于是 V4 把内核与扩展、配置与控制台重新理了一遍;文档站、WebUI、AI、社区统计、插件索引也各自成仓。生态才刚起了个头,后面怎么长,还盼着大家一起养。

一路走来,我更盼的是:维护的人更好配一点,写插件的人更好下手一点;群里那台复读机还在,只是脚下的地,终于更踏实了一些。

💻 开发与贡献

欢迎通过 Issues / PR 参与改进。参与前请阅读 贡献指南 与仓库根目录 AGENTS.md

公开进展 / 里程碑 用户公开进展
贡献指南 CONTRIBUTING
Agent 约定 AGENTS.md

🤝 社区与支持

💬 QQ 群

开发者 开发者群 Notion 牛牛协作区
拉牛牛 西海福牛养殖基地 牛牛工坊
闲聊 西海福牛养殖学院 丽丽玛玛玛
社区中心 社区中心
在线部署 / 牛牛 deployments online bots online

💝 打赏

请作者喝杯咖啡吧(请备注牛牛项目,感谢你的支持 ✿✿ヽ(°▽°)ノ✿):

爱发电

🙏 致谢

📈 数据与贡献者

Star History of PallasBot/Pallas-Bot Pushes and Commits of PallasBot/Pallas-Bot Active Contributors of PallasBot/Pallas-Bot - Last 28 days

感谢各位大佬!

Contributors

📄 许可证

本项目采用 AGPL-3.0(GNU Affero General Public License v3.0)许可证。