rpi
首页文档扩展对比博客
RUST NATIVE CODING AGENT

更小,更快,
更方便的 Agent。

一个 Rust 原生编程 Agent,把读写代码、执行命令和会话管理带进你的终端。下载独立二进制,配置模型就能开始;也支持插件扩展与 Rust SDK 嵌入。

  • 更小独立二进制,少一层依赖
  • 更快Rust 原生,低启动开销
  • 更方便配置模型,终端直接用
MIT LicenseLinux / macOS / Windows无网络也能测试
rpi / agent-session示例会话
$rpi
›读一下 README,帮我梳理项目结构。
read README.md
bash rg --files
已梳理入口、核心模块和测试目录。
你可以继续追问,也可以让我修改代码。
RUST NATIVE一个二进制
OPEN SOURCEMIT LICENSE
21.8 MiB单文件安装体积 · 基准版本
10.7×冷启动更快 · 离线基准 / vs pi
1/7.6启动后内存 · 离线基准 / vs pi
1独立二进制 · 无需 Node.js 运行时
Windows 11 离线基准 · rpi 0.3.6 / pi 0.87.1 · 2026-09-30 · 不含模型推理查看测量方法与数据 ↗
BUILD IN THE OPEN

觉得有用?
给 rpi 一颗 Star。

让更多开发者发现 rpi。也欢迎提交 Issue、分享用法,或一起贡献代码。

01 / WHY RPI

从一条 prompt,
长出完整系统。

Agent 不应该被锁在一个 CLI 里。rpi 把模型、循环、工具、会话和终端体验拆成可以独立替换的 Rust 层,让你从最小实验开始,逐步长成自己的产品。

02 / ARCHITECTURE

每一层都有自己的边界。

从 Provider 到 CLI,单向依赖让核心库保持轻盈,也让你的扩展有明确的落点。

03 / START SMALL

先跑起来,
再加复杂度。

两个示例覆盖最重要的学习路径:先用 faux provider 跑通 Agent,再把真实文件系统和工具接进循环。

examples/minimal/src/main.rs
确定性的本地 provider,不需要 API key。浏览 examples ↗
04 / EXTEND THE LOOP

把你的能力
插进 Agent。

Rust cdylib 插件通过稳定 ABI 接入 Tool、Provider、Slash Command、事件和资源发现。宿主保留生命周期,插件只关注自己的能力。

了解插件系统
05 / RELEASES

小步发布,持续靠近。

核心能力优先稳定下来,再把更多 Provider、插件生态和 CLI 体验交给社区。

06 / GET STARTED

你的 Agent,
从这里开始。

想直接使用 CLI 就安装 rpi-cli;想研究 Agent loop,再拉源码运行 faux provider。

安装预编译二进制(无需 Rust 工具链)
$curl -fsSL https://raw.githubusercontent.com/bigfish1913/pi-rust/main/scripts/install.sh | sh
直接安装 CLI
$cargo install rpi-cli
从源码运行示例
$git clone https://github.com/bigfish1913/pi-rust.git && cd pi-rust && cargo run -p minimal