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

相關