pi_agent_rust

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 232 🐛 待处理 12 👀 关注 18

GitHub ↗

GitHub 星标 ★ 1971

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，基于 Rust 的 AI 编程代理 CLI，可自行部署，完全免费。

项目预览

pi_agent_rust 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类智能体

开发团队Dicklesworthstone

GitHubhttps://github.com/Dicklesworthstone/pi_agent_rust

定价模式🏷️完全免费

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

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议NOASSERTION

主要语言Rust

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

GitHub 星标★ 1971

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

代码更新2026-11-09

仓库体积304.8 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数4

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1971

技术标签

ai-agents cli developer-tools rust

使用教程

难度：入门约 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 条目，操作幂等且非破坏性。