牛牛就是复读机——群友说什么牛牛就说什么。
喜欢牛牛,就给牛牛点个 ⭐ 吧!
✨ 特性
- 学习型复读:从群聊语料学习,自动接话、跟复读与贴表情;接话积极度与复读频率可调
- 语料联邦:可选接入社区共享语料池,扩充接话短句来源;多部署可共池互认,按群归属与消息抢占去重,避免重复回复
- 语义风格指导:由复读引擎按账号与群维度学习「什么场合常说什么」,作为群表达指导注入 LLM 对话;同群不同账号互不干扰
- LLM 对话:明确
@时经 Bot Provider 多轮对话,支持群内长期记忆、人物观察、知识检索、联网搜索与工具调用;输出受账号人格与本群表达风格约束 - WebUI 控制台:浏览器管理配置、插件、命令权限与消息审查,并内置 LLM / AI 观测与运维面板
- 插件生态:可从内置商店安装插件,原生支持 NoneBot 插件
- 高并发消息处理:后台任务可靠投递,慢操作不阻塞消息主路径;多 worker 分片横向扩展
- 可选能力:
🚀 快速开始
[!NOTE] 前置:Python 3.12+、PostgreSQL、 OneBot v11 协议端(如 NapCat)。
不想装 Python 时,可用 Docker 部署。
# 获取代码
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 | 唱歌 / TTS 等 AI Runtime |
| TogetsuDo on Hugging Face | 社区 RVC / DDSP-SVC 音色模型下载 |
| Pallas-Bot-Community-Stats | 社区统计与语料中心服务 |
| community-plugin-index | 社区插件商店索引 |
💭 碎碎念
V3 走到后来,市面上那些 Bot 已经能接话、能记上下文、能把模型用得很顺;牛牛多半还是群里那台搞怪用的复读机,冷不丁冒出一句,把气氛带歪一点点。
![]()
群友喜欢她,也是喜欢牛牛的神鬼搞怪。可若只停在记语料、偶尔抛一句,在 LLM 已经走进日常的今天,再假装什么都没发生,其实也有点说不过去。
所以 V4 并不是想给牛牛硬套一张 AI 皮。接上模型,是这个时代绕不开的一步;不接的话,很多「对话」相关的期待,我们自己也接不住。可我仍想把复读放在前面——模型轻轻托一把就好,群友的话才是她真正的声音。这一块也才刚起步,接得还生,偶尔也会闹别扭,还不成熟;但不想让她变成随便哪都能见到的通用聊天壳。
V3 的内核已经有点撑不住了——配置散、约定乱、控制台和运行时也对不太齐,继续堆只会越来越累。于是 V4 把内核与扩展、配置与控制台重新理了一遍;文档站、WebUI、AI、社区统计、插件索引也各自成仓。生态才刚起了个头,后面怎么长,还盼着大家一起养。
一路走来,我更盼的是:维护的人更好配一点,写插件的人更好下手一点;群里那台复读机还在,只是脚下的地,终于更踏实了一些。
💻 开发与贡献
[!Important] 想为牛牛做贡献,请先阅读 贡献指南 与 AGENTS.md。若要一起跟进任务,可通过下方邀请加入 Notion 协作区。
| 贡献指南 | |
| Agent 约定 | |
| 协作区邀请 |
🤝 社区与支持
🌐 社区中心
Pallas-Bot 社区中心 是面向大家的公开主站:可看在线部署与牛牛数量,逛金句投稿墙;也可直接在主站 投稿。
| 社区中心主站 | |
| 金句投稿 | |
| 在线部署 / 牛牛 |
|
💬 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)许可证。
Metadata
Release files for pallas-core 4.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pallas_core-4.3.1-py3-none-any.whl | Python 3 | none | any | Details |
Release files / pallas_core-4.3.1-py3-none-any.whl
| Download URL | pallas_core-4.3.1-py3-none-any.whl |
|---|---|
| Size | 1.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c3b1bac64be26e68a5795ec8cfc876ba171bbf8032020612ca70b352b1ce1b81
|
|
BLAKE2b-256 checksum How to use checksums |
a8fc74d7f83276e1d3277eed4cdcb53539ba4b137484cbb6dd3cae43d8275178
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 17, 2026.
Transparency log