bitterbot-desktop

本地运行、懂你情绪、还能买卖技能的 AI 桌面助手

bitterbot-desktop 是一个本地优先的 AI 智能体桌面应用，主打持久记忆、情感智能和点对点技能经济。它解决的是传统 AI 助手缺乏长期记忆、交互生硬以及能力封闭的问题。核心能力包括：通过认知架构实现跨会话的持久记忆，让 AI 记住用户偏好和对话历史；内置情感引擎，能识别并回应用户情绪，使交互更自然；同时内置去中心化的技能市场，用户和 AI 可以发布、交易技能，形成点对点的技能经济生态。项目采用 TypeScript 开发，基于 A2A 协议实现智能体间通信，支持本地运行，数据隐私性强。目前处于成长阶段，适合对 AI 个性化、隐私保护和去中心化生态感兴趣的开发者或技术爱好者探索。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2460

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队Bitterbot-AI

所属国家

官网地址https://bitterbot.ai

GitHubhttps://github.com/Bitterbot-AI/bitterbot-desktop

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型a2a-protocol,agent-economy,agent-memory,ai-agent,chatbot,cognitive-architecture,decentralized-ai,desktop-app,dream-engine,local-first,multi-channel,open-source,p2p,personal-ai,skills-marketplace,typescript,x402

GitHub 星标★ 2460

30天Star增速

HF 下载量

上线时间2026-03-28 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

难度：进阶约 20 分钟部署方式：本地安装 8 步

环境要求

Node.js ≥ 22
包管理器 pnpm（可用 corepack 启用）
系统依赖：ffmpeg、ripgrep、jq 等（由 scripts/setup-deps.sh 安装）
Playwright Chromium（浏览器自动化用）
Windows 用户需使用 WSL2，并克隆到 Linux 文件系统（如 ~/bitterbot-desktop）

安装与启动步骤

1启用 pnpm

项目指定使用 pnpm。若本机没有 pnpm，用 corepack 启用，失败则改用 npm 全局安装。
```
corepack enable pnpm || npm install -g pnpm
```
2克隆并进入仓库

把 bitterbot-desktop 源码克隆到本地并进入项目根目录，后续命令都在该目录执行。
```
git clone https://github.com/Bitterbot-AI/bitterbot-desktop.git && cd bitterbot-desktop
```
3安装系统依赖

执行仓库自带脚本安装 ffmpeg、ripgrep、jq 等系统级依赖，需要系统包管理器权限。
```
bash scripts/setup-deps.sh
```
4安装项目依赖

在项目根目录安装 TypeScript 项目依赖，耗时较长，请保持网络畅通。
```
pnpm install
```
5安装浏览器内核

安装 Playwright 的 Chromium 及系统依赖，供智能体做网页浏览自动化使用。
```
pnpm exec playwright install --with-deps chromium
```
6运行引导向导

向导会依次配置模型鉴权(API Key)、记忆嵌入、网络搜索、渠道、钱包和工作区，并自动启动网关与 Control UI、打开浏览器。
```
pnpm bitterbot onboard
```
7访问控制台

向导完成后 Bitterbot 已在运行，浏览器访问该地址即可聊天、查看梦境、管理技能；不要在服务器上改端口。
8手动再次启动

若跳过了向导的自动启动，用此命令启动网关（自带 Control UI）。首次运行会自动构建 dist/entry.js 并准备 UI，无需单独 pnpm build。
```
pnpm start:all
```

关键配置

配置项	必填	说明	示例
`gateway.auth.token`	是	网关认证令牌，从另一台机器指向远程网关时需要	`~/.bitterbot/bitterbot.json → gateway.auth.token 中的实际值`

如何确认成功

浏览器打开 http://127.0.0.1:19001 能看到 Bitterbot Control UI，即网关与 UI 已正常运行。

常见问题

Q：Windows 上启动特别慢怎么办？

A：必须使用 WSL2，并把仓库克隆到 Linux 文件系统（如 ~/bitterbot-desktop），不要放在 /mnt/c/...，9p 挂载实测会慢约 43 倍。

Q：可以从另一台机器访问 Control UI 吗？

A：可以。用 SSH 隧道：ssh -N -L 19001:127.0.0.1:19001 user@host，再打开 http://127.0.0.1:19001 ；或在首次运行界面填入远程网关及其 token。

Q：向导结束后下次怎么启动？

A：执行 pnpm start:all，网关会自动拉起并同时提供 Control UI。若已在运行则会跳过。

Q：需要单独启动 P2P orchestrator 吗？

A：不需要。orchestrator（P2P sidecar）由网关自动派生启动，一个进程、一个端口。

Q：想改源码调试怎么跑？

A：用 pnpm dev:all（网关 tsdown --watch + Vite 热重载），或开两个终端分别执行 pnpm gateway:watch 和 cd desktop && pnpm dev。

注意事项

Control UI 与网关同源同端口（19001），在运行网关的本机直接打开即可，无需手动配置令牌。
首次 pnpm start:all 会自动构建 dist/entry.js 并准备 Control UI，不需要单独执行 pnpm build。
desktop/.env 只是 pnpm dev:all 开发模式的覆盖配置，正式使用不需要。
项目为本地优先设计，记忆与数据保存在本地，隐私性更强。

核心亮点

持久记忆：跨会话记住用户偏好和上下文，体验更连贯
情感智能：识别情绪并调整回应，交互更自然
点对点技能经济：可发布/交易技能，扩展 AI 能力

不足之处

文档/社区待观察
技能经济生态尚需培育，初期可用技能可能有限

适用场景

个人隐私敏感的日常 AI 助手场景
需要长期记忆的个性化对话场景
开发者或爱好者探索去中心化 AI 生态

替代项目

Open Interpreter、AutoGPT、Cognosys

项目介绍

bitterbot-desktop 是智能体领域的开源项目，由 Bitterbot-AI 开发，是 2026 年新上线的项目。

在全站 13,109 个收录项目中，它的 GitHub 星标数（2,460）位列前 30%，在智能体分类的 2,520 个项目里位列前 15%。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。从国内网络环境看，可直接访问。

它主要面向的使用场景是：个人隐私敏感的日常AI助手场景。同类可对比的替代方案包括 Open Interpreter、AutoGPT、Cognosys。

上一篇：claude-code-from-scratch

下一篇：agent-rules-books