Bitterbot-AI/bitterbot-desktop

Bitterbot - a mesh of agents that turns shared experience into collective capability.

Bitterbot – 本地优先的个人AI

是什么 – Bitterbot 是一个开源桌面应用程序，在您自己的计算机上运行一个自包含的AI“代理”。与仅将用户提示转发到远程LLM的典型聊天机器人不同，Bitterbot 保持持久的、生物启发的记忆，可以执行工具（网页浏览、代码执行、WhatsApp消息发送），并定期“做梦”以整合所学知识。它还包含一个小型点对点（P2P）市场，代理可以出售经验证的技能以换取USDC，但货币层是可选的。

核心概念

生物风格记忆 – 事实以 知识晶体 形式存储，除非被强化，否则会衰减，模仿艾宾浩斯遗忘曲线。激素系统（多巴胺、皮质醇、催产素）每回合调节代理的语气和专注度。
梦境引擎 – 每隔几小时，代理会离线并运行一组“梦境”模式（重播、变异、压缩、研究等），重新组织其记忆，创建新的可重用技能，并以 梦境质量评分 评估结果。
持续回忆 – 当查询超过令牌窗口时，Bitterbot 会启动一个沙盒化的子LLM，搜索完整的1000万令牌历史记录并缓存结果。
可执行技能与拦截器 – 技能以Markdown定义，但可通过确定性代码拦截器保护，这些拦截器可查看代理的激素状态，并可修改、批准或阻止工具调用。
P2P技能市场 – 代理可以发布经验证的技能（带Ed25519签名）并在Base测试网赚取USDC；钱包默认处于禁用状态。

如何开始

安装 Node ≥ 22（仓库自带Corepack）。启用 pnpm：
```
corepack enable pnpm || npm install -g pnpm
```

克隆仓库并使用提供的脚本安装系统依赖（ffmpeg、ripgrep、jq等）：

git clone https://github.com/Bitterbot-AI/bitterbot-desktop.git && cd bitterbot-desktop
bash scripts/setup-deps.sh
pnpm install
pnpm exec playwright install --with-deps chromium

运行引导向导，逐步完成API密钥输入（Anthropic、OpenAI、Tavily、Brave等）、记忆嵌入设置、频道配置以及可选的钱包创建：
```
pnpm bitterbot onboard
```
向导完成后，网关和控制UI将自动启动。在浏览器中打开 http://127.0.0.1:19001 以聊天、查看梦境、管理技能并监控代理。

开发时可使用监听模式：

pnpm dev:all          # 热重载网关 + Vite UI
# 或分两个终端
pnpm gateway:watch
cd desktop && pnpm dev

主要组件

服务	URL	作用
网关	`ws://127.0.0.1:19001`	UI、CLI和外部客户端使用的WebSocket API
控制UI	`http://127.0.0.1:19001`	浏览器端仪表板，显示聊天、梦境、技能库和诊断信息
编排器（P2P侧车）	由网关自动启动	处理去中心化技能交换和钱包交互

典型用例

个人知识助手 – 记住您的偏好、项目细节和过往对话，无需每次重新提示LLM。
工具增强自动化 – 可代表您浏览网页、运行shell命令或发送WhatsApp消息。
研究助手 – 梦境引擎的研究模式可自主获取信息并将其存储为可重用技能。
实验平台 – 开发者可以原型设计新的记忆架构、激素模型或技能拦截器，并在本地查看其运行效果。

限制与当前状态

货币功能（USDC钱包、P2P技能交易）为 可选且实验性；运行在测试网，需要显式配置。
记忆整合和梦境周期对CPU要求高；文档建议使用现代桌面电脑，并建议仅在机器空闲时运行梦境引擎。
系统主要依赖外部LLM API（Anthropic、OpenAI等）进行推理；只有 深度回忆 子LLM在本地沙盒中运行。
Windows支持仅限WSL2；原生Windows执行未正式测试。
截至最新发布版本（2026.2.15），项目仍在积极开发中，部分文档（如 LIMITATIONS.md）警告某些功能可能变更。

了解更多

文档 – docs/ 包含关于记忆架构、深度回忆、拦截器和梦境引擎的详细章节。
实时示例 – README 包含一个真实的 MEMORY.md 快照，展示代理自动生成的工作记忆。
社区 – 关注 X（@Bitterbot_AI）以获取更新和讨论。

以上所有信息均直接取自仓库的README；未推断任何额外功能。

Bitterbot-AI/bitterbot-desktop

Bitterbot – 本地优先的个人AI

相关