rpi
HomeDocumentationPackagesGitHub ↗
RUST AGENT TOOLKIT

把 Agent 做成
你自己的工具。

rpi 是一个 library-first 的 Rust SDK。用清晰的分层、可替换的模型 Provider 和真正可测试的工具循环,构建属于你的 coding agent。

MIT LicenseRust 1.78+无网络也能测试
rpi / agent-session LIVE
$ cargo run -p minimal
01Agent::prompt("hi")
02stream.start · faux-1
03↳ assistant_message
04Hello from the faux provider!
05message.end · 18ms
AgentEnd observed. 2 messages after run
STREAMING18ms
COMPOSABLE6 crates
6个可组合 crate
2种内置 Provider
7个开箱即用工具
0网络依赖的测试
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,
从这里开始。

先拉代码,运行一个不需要 API key 的 faux provider。理解闭环,再替换成自己的模型和工具。

$git clone https://github.com/bigfish1913/pi-rust.git && cd pi-rust && cargo run -p minimal