项目介绍
PiBot 是一个在自己电脑上运行 AI 代理团队的桌面应用。你可以直接和一个代理对话,也可以把多个代理放进群聊:由协调者规划任务、分派步骤并汇总结果。代理能在你指定的工作文件夹里规划、执行命令、修改文件、浏览网页和操作电脑,每个风险步骤都要经过审批策略。代理内核是 pi,以 npm 依赖形式固定引入;不依赖 Electron 的“大脑”包可以无界面运行。
每个代理可配置名称、角色(开发者、研究员、写作者、翻译等)、模型、技能、权限和记忆。内置角色与群组定义可离线使用,更完整的角色库在 pibot-roles。其他能力包括定时、文件夹触发或连接触发的例程,MCP 服务器与应用连接,以及可选的 Android 客户端、无界面 runner、自托管中继和通过 ACP 在编辑器中使用。
快速使用
从源码构建需要安装 .nvmrc 指定的 Node 和 pnpm 12,然后执行:
git clone https://github.com/w01fb0ss/PiBot.git
cd PiBot
nvm use
pnpm install
pnpm dev
pnpm dev 会以开发模式启动桌面应用。设置 PIBOT_DATA_DIR 可把开发数据与已安装版本分开。pnpm check 执行安装、类型检查、lint、策略矩阵和测试;pnpm verify 还会构建并运行渲染进程冒烟测试和端到端验收套件。源码构建不产出安装包,pnpm build 只做 electron-vite 构建。
使用约束
桌面端支持 macOS 13 Ventura 及以上、Windows 10/11 和 64 位 Linux,移动端为 Android。命令在 @anthropic-ai/sandbox-runtime 沙箱中运行,代理操作、审批和外发请求会写入审计日志。项目声明不含遥测,自有服务器不接收聊天和文件;模型提示会发送给你配置的模型供应商。更新检查、代理访问的网站与搜索、以及手机、runner、连接等可选功能会产生其他外发连接,详见外发连接说明。
模型可使用 Ollama 本地模型、OpenRouter、自备 API Key 或受支持的订阅登录。项目采用 Apache-2.0 许可。仓库把 Electron 桌面端、Android 端、中继、无界面 runner、CLI、内置插件和分层代理包分开;代理架构见 AGENTS.md,参与贡献前先读 CONTRIBUTING.md。
HotRepo 点评
该项目在 2026-11-21 首次进入 HotRepo 新项目榜,当天约 10 小时的统计窗口内新增 116 Star 和 16 Fork。这个量只能说明发布初期有关注度,单条快照不足以判断趋势。代码结构支撑了产品描述,而非只把仓库当作官网入口:桌面端、移动端、中继、runner 和 CLI 分开成应用,包含 125 个技能文件以及包级测试。最值得进一步核查的是统一的审批策略引擎、沙箱命令执行和审计日志,这三者决定了代理实际能获得多少自主权。
本文由 AI 根据项目公开资料和 HotRepo 的记录撰写,更新于 ,以项目官方文档为准。
相关推荐
- totec448-spec/chat-on-steroids让 ChatGPT 通过本地 MCP 读写文件、执行命令并拆分多智能体任务的桌面工作台。
- agentes-chat/agentes-chat自托管团队聊天工具,让人和 AI 代理在频道、私信里协作并审批敏感操作。
- Verlintas/NovaBAIC本地优先的 Android AI 智能体,通过 58 个设备工具实现看屏、UI 自动化、文件管理与定时任务。
- androoAGI/starnet一个本地优先的桌面 Agent 运行环境:多个 AI agent 各自在独立工作区并行干活,像素风空间站的布局即权限与协作流程。
- tinyhumansai/openhuman为需要在单台小服务器上低成本运行数百个 LLM agent 的场景准备的 Rust agent harness,兼具桌面应用与库两种用法。