Recursive：Rust 编写的可嵌入编程智能体内核与开发平台

核心能力与快速开始

★ 4 · Rust

能做什么

核心为 ReAct 智能体循环，组合 LLM 提供方（默认 OpenAI 兼容 HTTP，另含 Anthropic 适配器和 Mock 提供方）、工具注册表（Read、Write、Edit、Glob、Bash、WebFetch、WebSearch、计划模式、检查点、todo 等，另有协调者专用工具）以及 transcript 与 StepEvent 事件流。内核包含 Message、ChatProvider、Tool 与 ToolRegistry、无状态的 AgentKernel 和有状态的 AgentRuntime。平台层可选功能包括：基于 axum 的 HTTP REST+SSE API（会话、限流、JWT/API Key 认证、OpenAPI 规范）、MCP 客户端与服务器、基于 ratatui 的 TUI、多智能体（智能体池、共享记忆、消息总线）、云运行时（Redis 会话存储、S3 transcript 存储、Docker/E2B 沙箱）、向量记忆（sqlite-vec + OpenAI 嵌入）以及自调度的 loop 模式。通过 --no-default-features 可仅嵌入内核。

适用场景

可用于构建编程智能体或自动化开发工具：以一次性命令或交互式 REPL 执行代码库探索、文件增删改、Shell 命令执行与网页抓取等任务；通过 HTTP API 将智能体接入其他服务；作为 MCP 服务器向其他智能体暴露工具，或作为 MCP 客户端消费外部工具；使用 TUI 进行交互式开发；运行多智能体并行协作与自调度循环任务。

项目形态

可直接使用的工具

部署方式

提供 Homebrew（macOS Apple Silicon）、Linux/macOS/Windows 预编译二进制、cargo 源码安装以及 Docker 单容器部署；完整云栈可用 docker-compose 启动 Redis 与 LocalStack S3。HTTP 服务器默认要求配置 RECURSIVE_HTTP_AUTH_KEYS 或 JWT 密钥，否则返回 503，本地开发可用 RECURSIVE_HTTP_AUTH_INSECURE_OK=1 绕过。

主要依赖

需要 Rust 工具链（源码安装）或直接下载二进制；需要配置 LLM API 端点与密钥（RECURSIVE_API_BASE、RECURSIVE_API_KEY、RECURSIVE_MODEL），可使用 OpenAI、GLM/Zhipu、DeepSeek、Moonshot、MiniMax、Together、Ollama、vLLM 等兼容服务。云运行时、MCP、TUI 等能力需启用对应 feature 或运行对应 crate。

使用限制

README 提到 Redis 与 S3 云存储在 http 模式下尚未接线（仅识别并打印启动日志）；多 worker 并行长任务在默认无限墙钟预算下可能因单个 worker 卡住而挂起父轮次，建议设置 RECURSIVE_WALL_TIMEOUT_SECS；默认模型设为 gpt-4o-mini，使用需自备 API 密钥，调用 API 会产生费用；未说明默认是否可商用。

许可证

MIT

最近推送

2026-10-04 01:22

资料检查：2026-10-04 07:00 · 卡片整理：2026-10-04 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证 · 本次更新未完成，保留上次成功内容