pi_agent_rust

用 Rust 打造极速安全的 AI 编程助手，让编码效率飞起

pi_agent_rust 是一个用 Rust 编写的高性能 AI 编程助手命令行工具，主打零 unsafe 代码的安全性和极速执行。它解决开发者在使用 AI 编码代理时常见的性能瓶颈和内存安全问题，通过 Rust 的系统级能力实现低延迟响应和高效资源利用。核心能力包括智能代码补全、上下文感知的代码生成、多文件项目级重构建议，以及无缝集成主流 Git 工作流。其设计强调可扩展性，支持自定义模型后端和提示模板，便于团队适配内部规范。项目处于成长期，社区活跃，文档逐步完善，适合追求极致性能和严格内存安全的中高级开发者尝试。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1776

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队Dicklesworthstone

所属国家

官网地址

GitHubhttps://github.com/Dicklesworthstone/pi_agent_rust

定价模式free

价格说明开源项目，基于 Rust 的 AI 编程代理 CLI，可自行部署，完全免费。

访问状态

是否开源是

开源协议NOASSERTION

主要语言Rust

技术栈/模型ai-agents,cli,developer-tools,rust

GitHub 星标★ 1776

30天Star增速

HF 下载量

上线时间2026-02-02 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 5 分钟部署方式：命令行工具 6 步

环境要求

终端可用 curl 与 bash（安装脚本为 shell 脚本）
可访问 GitHub raw 与 releases 下载制品
如需代理，可设置 HTTPS_PROXY / HTTP_PROXY 环境变量
可选：已安装原 TypeScript 版 pi 时需决定是否迁移

安装与启动步骤

1安装最新版 pi

用官方安装脚本下载并安装单文件二进制 pi；脚本幂等，重复执行安全。
```
curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/pi_agent_rust/main/install.sh?$(date +%s)" | bash
```
2查看配置路径

确认安装成功并查看设置文件路径与配置优先级，便于后续修改模型等选项。
```
pi config
```
3单次提问运行

用单次模式执行一条指令后退出，适合脚本或 CI 中调用。
```
pi -p "List likely regression risks for this diff"
```
4交互式启动

直接运行进入交互会话，按 pi [OPTIONS] [MESSAGE]... 形式传入选项与消息。
```
pi
```

5静默最小安装

CI 或非交互环境用 --yes --no-completions 跳过补全安装与交互确认。

curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/pi_agent_rust/main/install.sh?$(date +%s)" | bash -s -- --yes --no-completions

6卸载

运行卸载脚本，移除安装器管理的二进制、别名与技能目录，并恢复被迁移的 TS pi。
```
curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/pi_agent_rust/main/uninstall.sh" | bash
```

关键配置

配置项	必填	说明	示例
`default_provider`	否	默认模型服务提供方，兼容原 TS 版 camelCase 写法。	`anthropic`
`default_model`	否	默认使用的模型名称。	`claude-opus-4-5`
`default_thinking_level`	否	默认思考（推理）强度等级。	`medium`
`compaction.enabled`	否	是否开启上下文压缩以节省 token。	`true`
`compaction.reserve_tokens`	否	预留的 token 数量。	`8192`
`compaction.keep_recent_tokens`	否	压缩时保留的近期对话 token 数。	`20000`

如何确认成功

执行 pi config 能正常输出设置路径与优先级，或 pi -p "..." 能返回结果即安装成功。

常见问题

Q：已经装过 TypeScript 版 pi 怎么办？

A：安装器会检测旧命令并询问是否把 Rust Pi 设为标准 pi，旧 CLI 会保留为 legacy-pi，迁移状态被记录以便干净卸载恢复。

Q：怎么在 CI 里做无交互安装？

A：给安装脚本传 --yes --no-completions，跳过完成脚本安装与交互提示；--no-completions 与 --completions off 等价。

Q：安装时会不会往别的工具写文件？

A：默认会安装 pi-agent-rust skill 到 ~/.claude/skills/ 和 ~/.codex/skills/，可用 --no-agent-skills 跳过。

Q：下载很慢怎么办？

A：安装器会遵循 HTTPS_PROXY / HTTP_PROXY 环境变量进行所有网络请求，设置代理后重新执行即可。

Q：怎么彻底卸载？

A：执行官方 uninstall.sh，默认删除安装器管理的 Rust 二进制、别名与技能目录，并恢复被迁移的 TypeScript pi。

注意事项

配置文件位于 ~/.pi/agent/settings.json，字段同时接受 snake_case 与 TS Pi 的 camelCase 写法，原文件不会被改写。
安装器默认做校验和与签名验证，--no-verify 会跳过校验，仅供测试使用。
指定 --artifact-url 但未带 --version 时使用合成 tag，制品下载失败会直接退出而不回退源码编译。
升级时若存在先前安装器状态，会自动清理旧版本遗留的 pre-tool 条目，操作幂等且非破坏性。

核心亮点

零 unsafe 代码保证内存安全，降低崩溃和漏洞风险
Rust 原生性能，启动和响应速度远超同类 Python 工具
支持自定义模型后端，灵活接入不同 AI 服务

不足之处

项目较新，生态和插件不如成熟项目丰富
文档/社区待观察

适用场景

大型项目中的快速代码生成与重构
对内存安全要求极高的系统编程场景
需要低延迟 AI 辅助的本地开发环境

替代项目

Aider、Cursor CLI、OpenAI Codex CLI

项目介绍

pi_agent_rust 是智能体领域的开源项目，由 Dicklesworthstone 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,776）位列前 30%，在智能体分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,570 增加到 1,776，净增 206。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。基于 Rust 的 AI 编程代理 CLI，可自行部署，完全免费。

它主要面向的使用场景是：大型项目中的快速代码生成与重构。同类可对比的替代方案包括 Aider、Cursor CLI、OpenAI Codex CLI。

上一篇：Job_search_agent

下一篇：voiceai