跳到主要内容

personal-bot自托管的个人助理

部署在自有设备上,记忆保存在本地文件,直接在日常使用的聊天软件中回复消息。

运行前必读

本项目通过驱动第三方桌面客户端运行,不属于该客户端服务条款允许的范围,可能导致账号受限或封禁。请使用已有正常使用记录的小号,在家庭宽带环境下运行,并保持默认的发送节奏。本项目为个人研究项目,按“现状”提供,一切风险由使用者自行承担。运行前请先阅读免责声明。

项目架构 ​

整套服务由四个容器组成,一套实例对应一个账号:qq 容器在虚拟屏幕中运行官方桌面客户端,bot 容器运行模型,console 容器提供 Web 管理面板,模型的命令行操作则在隔离的 sandbox 容器中执行。

一套实例的架构:官方桌面客户端无头运行并写入本地数据库;驱动服务读取该数据库,为 console 与 bot 提供服务,并经客户端自身发送消息、按需下载媒体;模型的命令在 sandbox 中以非特权用户执行

从这里开始 ​

支持 pi 生态内的全部模型 ​

模型运行在 pi 框架之上,支持 pi 集成的所有模型服务商与视觉模型。在控制台的模型与 Jev页面即可登录服务商或配置 API key。模型目录在服务启动时自动拉取,此后每天自动刷新一次(设置 PI_OFFLINE=1 时关闭联网拉取),也可随时在页面顶部手动刷新,新发布的模型无需重启容器即可选用。

完整项目说明见仓库 README;轮次、上下文与记忆机制的详细对比见 docs/how-it-works.zh-CN.md。