bigfish1913/pi-rust

这是什么？

核心功能

• 01通过 rpi-agent 与 rpi-ai 提供可嵌入的智能体循环，无需 CLI 即可使用。
• 02确定性的离线 faux 提供商，测试和示例无需网络。
• 03会话以 JSONL 树保存，崩溃后可恢复。
• 04内置 read、write、edit、bash、grep、find、ls 等工具。
• 05基于 cdylib 的插件 ABI，可注册工具、提供商和命令。
• 06无界面服务端模式，配合通过 TCP 连接的轻量 TUI 客户端。

适用场景

• 在自己的 Rust 应用中嵌入带自定义工具和事件处理的编程智能体。
• 在没有 API Key 或网络的情况下为智能体流程编写离线测试。
• 在性能较强的机器上运行终端编程智能体，并从另一台机器的轻量客户端远程操作。
• 开发一个既能在全局 CLI 中使用、也能在嵌入式智能体中使用的工具插件。

快速上手

1. 1

   从 crates.io 安装 rpi 命令行工具（需要 Rust 1.88+）

   cargo install rpi-cli
2. 2

   设置模型提供商的 API 密钥

   export ANTHROPIC_API_KEY=...
3. 3

   启动交互式终端界面

   rpi

使用前须知

• !从 crates.io 或源码安装需要 Rust 1.88 或更新版本。
• !Homebrew 公式仅支持 macOS 上的 Apple 芯片；Intel Mac 需使用预编译安装脚本或 cargo。
• !使用真实模型运行命令行需要模型提供商的 API 密钥或 models.json 配置。

收录于专题

标签

常见问题

pi-rust 是什么？

用 Rust 编写的编程智能体运行时与终端 CLI（rpi），可嵌入使用，支持多模型提供商、工具、可恢复会话和插件 ABI。 rpi 是一个用 Rust 编写的编程智能体运行时，由十个可组合的 crate 构成，涵盖模型提供商适配、智能体循环、工具、会话持久化、终端界面和插件 ABI。同一套代码既可以作为 SDK 嵌入自己的进程，也可以直接通过 `rpi` 命令行使用，支持交互式 TUI、一次性执行和 JSON 事件输出。

pi-rust 可以免费使用吗？用的什么许可证？

pi-rust 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

pi-rust 还在维护吗？

活跃维护中。pi-rust 最近一次提交是在 2026年11月6日。

pi-rust 适合用来做什么？

在自己的 Rust 应用中嵌入带自定义工具和事件处理的编程智能体。 在没有 API Key 或网络的情况下为智能体流程编写离线测试。 在性能较强的机器上运行终端编程智能体，并从另一台机器的轻量客户端远程操作。 开发一个既能在全局 CLI 中使用、也能在嵌入式智能体中使用的工具插件。

pi-rust 怎么安装和运行？

从 crates.io 安装 rpi 命令行工具（需要 Rust 1.88+）: cargo install rpi-cli 设置模型提供商的 API 密钥: export ANTHROPIC_API_KEY=... 启动交互式终端界面: rpi

在哪里获取 pi-rust？

源代码和安装说明在 GitHub 上：https://github.com/bigfish1913/pi-rust