rpi：Rust 原生编码智能体运行时与终端 CLI

核心能力与快速开始

★ 98 · Rust

能做什么

提供九crate 组成的编码智能体栈：rpi-ai 提供提供方无关的消息、流式与工具 schema 类型，内置 Anthropic、OpenAI 兼容与 faux 提供方；rpi-agent 实现智能体循环、事件、钩子、队列与取消；rpi-tools 提供 read/write/edit/bash 以及 grep、find、ls、powershell 工具与 ExecutionEnv 接口；rpi-harness 负责会话树、JSONL 持久化、压缩、崩溃恢复与运行循环；rpi-tui 提供终端 UI 组件、布局、编辑器与记录渲染；rpi-cli 提供 rpi 二进制的 TUI、一次性与 JSON 三种模式、配置与插件加载；rpi-plugin-sdk 定义稳定的 #[repr(C)] 插件 ABI；rpi-extensions 提供宿主侧插件加载与跨 ABI 的异步工具桥接；rpi-telemetry 提供可选插桩的空实现契约。插件可注册工具、提供方、斜杠命令、事件处理器、markdown 渲染器与发现的资源。支持 rpi --server 无头服务端和 rpi --connect 远程 TUI 客户端。

适用场景

需要把编码智能体嵌入自有进程、使用自定义事件处理与输出而非调用外部 CLI 的开发者；希望完全离线、确定性运行智能体测试（faux 提供方与内存执行环境）的团队；需要会话在崩溃后从最后一个已提交帧恢复、不重复执行工具的长会话场景；通过稳定 C ABI 编写 Rust cdylib 插件以扩展工具、提供方与命令的扩展作者；使用 rpi --server 在性能较强的机器上运行智能体、用任意瘦终端通过 --connect 远程驱动的远程使用方式；以及直接安装 rpi 二进制作为终端编码智能体使用。

项目形态

开发框架

部署方式

可安装预编译二进制（安装脚本校验 SHA-256，安装到 /usr/local/bin 或 ~/.local/bin；Windows 安装到 %LOCALAPPDATA%\Programs\rpi）；也可通过 cargo install rpi-cli（需 Rust 1.78+）、Homebrew（目前支持 macOS Apple silicon）、Scoop 安装，或从源码克隆后构建。支持远程模式：rpi --server 以 TCP 无头运行并打印认证令牌，客户端用 --connect host:port --token T 连接。平台覆盖 Linux、macOS、Windows。

主要依赖

二进制安装无需 Rust 工具链；从 crates.io 或源码安装需要 Rust 1.78+（MSRV）。使用真实模型需设置 ANTHROPIC_API_KEY 或 OPENAI_API_KEY，或在 ~/.rpi/agent/models.json 中声明自定义 Anthropic 或 OpenAI 兼容网关，并通过 --model <provider>/<model> 选择。

使用限制

Homebrew formula 目前仅支持 macOS Apple silicon，Intel Mac 需使用带 x86_64-apple-darwin 资产的预编译安装器或 cargo install。winget 清单尚在审核中。插件安全规则被描述为具有约束力而非风格性要求。性能基准为作者在 Windows 11（x86_64）自行测量，且未测量 LLM 延迟、工具循环吞吐、长会话与 TUI 帧开销；与其他工具的对比数据标注为 2026-09 状态且会变化。远程模式的具体协议限制未在摘录中完整说明。

许可证

MIT

最近推送

2026-10-13 23:37

资料检查：2026-10-14 07:00 · 卡片整理：2026-10-14 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证

职业应用

程序员

作为终端编码智能体，在开发过程中执行读写文件、编辑代码、运行 bash/grep/find/ls 等工具，辅助代码编写、排错与仓库操作；也可作为嵌入式 SDK 将智能体循环集成到自己的 Rust 进程中。

官方使用入口 ↗

由 AI 根据来源材料整理，未进行安装或运行验证