lassejlv/pi-rs

这是什么？

核心功能

• 01单个原生 pi 可执行文件，提供与原版一致的 CLI，以及交互、打印、JSON 和 RPC 模式。
• 02会话、settings、auth、models 等文件与 TypeScript 版互相兼容，可共用同一个 agent 目录。
• 03无需 Node.js，即可在内嵌 JavaScript 引擎中运行 TypeScript 和 JavaScript 扩展。
• 04支持 Anthropic、OpenAI、Google、Bedrock、Mistral 等多家模型提供商。
• 05内置 MCP 客户端，支持 stdio 与 streamable HTTP 传输。

适用场景

• 在不便安装 Node.js 或 Bun 的机器上运行 pi 编码智能体。
• 让 Rust 版与 TypeScript 版共用同一个 agent 配置目录。
• 开发或移植需要在原生二进制中运行的 pi 扩展。
• 在终端编码智能体中接入 MCP 服务器。

快速上手

1. 1

   安装 Rust 1.88 或更新版本

2. 2

   构建发布版二进制文件

   cargo build --release
3. 3

   将 pi 二进制文件安装到 ~/.cargo/bin

   cargo install --path crates/pi-coding-agent
4. 4

   检查已安装的版本

   ./target/release/pi --version

使用前须知

• !仓库元数据中未声明许可证。
• !部分行为与 TypeScript 版 pi 不同，例如使用 Boa JavaScript 引擎，扩展的堆栈跟踪和错误信息会有差异。
• !尚未移植 Windows 终端后端。

收录于专题

标签

常见问题

pi-rs 是什么？

pi 编码智能体的 Rust 移植版，编译为单个原生 pi 可执行文件，CLI、终端界面、文件格式和扩展 API 与 TypeScript 版保持一致。 pi-rs 是 pi 编码智能体的 Rust 重写版本。pi 是一个精简且可扩展的编码智能体。项目编译出单个原生 pi 可执行文件，力求与 TypeScript 原版在命令行接口、终端界面、会话、settings.json、auth.json、models.json 等本地文件格式、RPC 协议和扩展 API 上保持一致。运行时无需 Node.js 或 Bun。

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

pi-rs 没有声明许可证。代码虽然公开，但没有许可证就没有明确的使用授权，正式使用前建议先联系作者。

pi-rs 还在维护吗？

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

pi-rs 适合用来做什么？

在不便安装 Node.js 或 Bun 的机器上运行 pi 编码智能体。 让 Rust 版与 TypeScript 版共用同一个 agent 配置目录。 开发或移植需要在原生二进制中运行的 pi 扩展。 在终端编码智能体中接入 MCP 服务器。

pi-rs 怎么安装和运行？

安装 Rust 1.88 或更新版本 构建发布版二进制文件: cargo build --release 将 pi 二进制文件安装到 ~/.cargo/bin: cargo install --path crates/pi-coding-agent 检查已安装的版本: ./target/release/pi --version

在哪里获取 pi-rs？

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