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 构建。