Skip to main content

Pallas Bot 内核框架 —— 基于 NoneBot2 的社区机器人 SDK

Project description

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-AI AI 对话 / 唱歌 / 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)许可证。

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pallas_core-4.0.3-py3-none-any.whl (892.7 kB view details)

Uploaded Python 3

File details

Details for the file pallas_core-4.0.3-py3-none-any.whl.

File metadata

  • Download URL: pallas_core-4.0.3-py3-none-any.whl
  • Upload date:
  • Size: 892.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for pallas_core-4.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 5488013dc2cb7f1331c20da4311bbc3ae8f22d8c5a81d54c9ff43b8342731043
MD5 b8d3d02d9f42429de7c82f51e42214c9
BLAKE2b-256 6f63ec671f1628adfe7286fb0a92c37f2bf70c83eff0ebbda9623901da450e32

See more details on using hashes here.

Provenance

The following attestation bundles were made for pallas_core-4.0.3-py3-none-any.whl:

Publisher: publish-pypi-core.yml on PallasBot/Pallas-Bot

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page