adolfousier/opencrabs

OpenCrabs – 自包含的 Rust 基礎 AI 智能體

簡介 – OpenCrabs 是一個用 Rust 編寫的、僅限終端使用的單二進位檔案 AI 助手。它透過 HTTPS 直接與 LLM 供應商（OpenAI、Anthropic、Gemini、Claude、Ollama 等）通訊，將所有資料儲存在本地（SQLite 聊天、嵌入、brain 檔案、API 金鑰），並且從不執行任何背景伺服器。該專案捆綁了一個基於 ratatui 構建的 TUI 以及用於輕鬆部署的選配 Docker 映像。

核心功能

類別	亮點
多供應商支援	支援數十種商業和本地模型；您可以鏈接回退供應商並按工作階段切換模型。
零遙測，本地優先	所有聊天、工具執行和記憶體都保留在主機上。出站流量僅限於您觸發的顯式 LLM/API 呼叫。
三層記憶體系統	• Brain 檔案（使用者整理的 Markdown） • 帶有自動摘要的每日日誌檔案 • 混合搜尋（FTS5 + 向量嵌入），可以使用極小的本地嵌入模型離線執行，或使用任何遠端 /v1/embeddings 端點。
動態工具系統	內建 bash、git、網路搜尋、GitHub CLI、瀏覽器自動化（Chromium CDP）以及在 tools.toml 中定義的通用 HTTP 工具。
多智能體編排	生成在隔離工作階段中執行的子智能體（探索、程式碼、研究等），並可透過 spawn_agent、wait_agent 等命令進行協調。
自我改進循環（實驗性）	記錄工具使用情況，分析回饋，並可以自動編輯其自身的 brain 檔案，記錄每個變更。
多模態輸入	可以附加圖片（路徑、URL、剪貼簿）和影片；智能體呼叫特定供應商的視覺工具（例如 Gemini）來分析它們。
本地語音	選配的離線 Whisper-cpp 轉錄和 TTS，全部打包在約 130 MB 中。
使用量儀表板	/usage 顯示每個專案/供應商的代幣計數、成本估算和活動圖表。
安全優先設計	API 金鑰從 RAM 中清零，沒有入站監聽器，二進位檔案是單一編譯產物（約 35 MB）。

如何開始

1. 安裝二進位檔案 – 下載預構建的發布版本，使用 cargo install opencrabs 構建，或執行提供的 Docker 映像。
2. 執行 opencrabs – TUI 啟動時帶有入門嚮導，引導您建立 keys.toml（您的供應商 API 金鑰）和選配的 config.toml。
3. 開始聊天。系統提示詞由 brain Markdown 檔案（SOUL.md、AGENTS.md、TOOLS.md 等）組裝而成，您可以隨時編輯。
4. 使用斜線命令（/goal、/cron、/tool …）觸發內建功能，或附加檔案以進行多模態處理。

文件與社群 – 完整文件託管在 https://docs.opencrabs.com（六種語言），專案的 GitHub 頁面包含基準測試、架構圖和「完整入門」影片。該儲存庫得到積極維護（CI 徽章、Trendshift 排名）並歡迎貢獻。

---

OpenCrabs 是一個真正的開源 AI 智能體框架，專注於隱私、效能和可擴展性，完全使用 Rust 構建。