终端里的
AI 编程搭档 The AI coding partner
in your terminal

Rpi 是一个用 Rust 编写的终端 AI 编程助手：读代码、改文件、跑命令、管理会话，全都在你的终端里完成。项目源自 Pi。 Rpi is a terminal AI coding assistant written in Rust: it reads code, edits files, runs commands and manages sessions — all without leaving your terminal. The project originates from Pi.

curl -fsSL https://revpi.dev/install.sh | sh

x86_64 / aarch64，glibc 与 musl 自动识别（--musl 可强制）；默认安装到 ~/.local/bin，--prefix 可覆盖。 x86_64 / aarch64, glibc vs musl auto-detected (force with --musl); installs to ~/.local/bin by default, override with --prefix.

curl -fsSL https://revpi.dev/install.sh | sh

Apple silicon（aarch64）；默认安装到 ~/.local/bin，--prefix 可覆盖。 Apple silicon (aarch64); installs to ~/.local/bin by default, override with --prefix.

irm https://revpi.dev/install.ps1 | iex

x86_64，PowerShell；默认安装到 %LOCALAPPDATA%\Programs\rpi，-Prefix 可覆盖。 x86_64, PowerShell; installs to %LOCALAPPDATA%\Programs\rpi by default, override with -Prefix.

也可以从 GitHub Releases 手动下载，或从源码构建。 You can also grab binaries manually from GitHub Releases or build from source.
交互式安装会询问是否把安装目录加入 PATH；CI/自动化请设置 RPI_NONINTERACTIVE=1 或 RPI_INSTALL_ADD_PATH=0，更多见安装说明。 Interactive installs offer to add the install directory to PATH; for CI/automation set RPI_NONINTERACTIVE=1 or RPI_INSTALL_ADD_PATH=0 — see the install guide.

MIT 开源MIT License Rust 单二进制Single Rust binary v0.1.7 42 家模型服务商42 model providers 插件可扩展Extensible

快速开始Get started GitHub 仓库GitHub

rpi — ~/develop/ai/rpi

ls crates/

rpi rpi-agent rpi-ai rpi-tui rpi-ext-host

分析一下本机的 CPU 和内存配置analyze this machine's CPU and memory

⠋ thinking… (level: high · 12s)

bash — lscpu | grep -E 'Model name|Socket' && free -h

✓ 完成✓ Done · read / bash / edit 工具可用 · 16 轮上下文已压缩 · read / bash / edit tools available · 16 turns compacted

本机为 AMD Ryzen 7 8845HS（8 核 16 线程），内存 32 GB DDR5-5600（2×16 GB）。This machine runs an AMD Ryzen 7 8845HS (8 cores / 16 threads) with 32 GB DDR5-5600 (2×16 GB).

把这段分析写进 notes.md 并提交write this analysis into notes.md and commit it

edit notes.md · +12 −0 · git commit ✓

Features

为什么是 RpiWhy Rpi

一个趁手的终端编程助手该有的样子：启动快、看得懂你的项目、改得动你的代码，还能按你的习惯扩展。 Everything a handy terminal coding assistant should be: fast to start, aware of your project, able to change your code, and easy to extend.

⚡Rust 单二进制Single Rust binary

编译产出是一个静态链接的可执行文件，不依赖 Node、Python 或任何运行时。拷到机器上就能跑，启动毫秒级。 Builds into one statically linked executable — no Node, no Python, no runtime at all. Copy it onto a machine and it just runs, with millisecond startup.

🖥️完整的终端体验A complete terminal UI

多轮对话、流式输出、代码语法高亮、斜杠命令、@ 模糊引用文件、会话树回看与分支——在终端里就是完整的工作台。 Multi-turn chat, streaming output, syntax highlighting, slash commands, @ fuzzy file references, and a session tree you can revisit and branch — a full workbench in your terminal.

🛠️真正能干活Gets real work done

内置读文件、改代码、执行命令等工具，长对话自动压缩上下文不中断；可以把会话导出成 HTML，或一键生成链接分享给同事。 Built-in tools for reading files, editing code and running commands, with automatic context compaction on long conversations. Export sessions to HTML or share them with a link.

☁️42 家模型服务商42 model providers

OpenAI、Anthropic、DeepSeek、Kimi、Google、Bedrock……开箱内置 42 家服务商的模型清单，填个 API Key 就能切换使用。 OpenAI, Anthropic, DeepSeek, Kimi, Google, Bedrock… model catalogs for 42 providers ship out of the box — add an API key and switch models anytime.

🔌插件可扩展Extensible with plugins

想用自己喜欢的语言写插件？Rpi 同时支持 WebAssembly 插件和原生动态库插件，挂载后无需重启即可热重载。 Write plugins in the language you like: Rpi supports both WebAssembly and native dynamic-library plugins, with hot reload — no restart required.

🔒隐私由你掌控Privacy under your control

不强制上传任何数据。模型目录、版本检查等网络请求都可以用环境变量逐项关闭，配置文件都在本机 ~/.rpi 目录下。 Nothing is uploaded unless you want it to be. Model catalog, version check and other requests can each be disabled via environment variables; all configuration stays local in ~/.rpi.

Quickstart

快速开始Quickstart

三分钟跑起来：一行命令安装，配上你的模型 Key，然后开始对话。 Up and running in three minutes: install with one command, add your model key, and start chatting.

1安装Install

# macOS / Linux
$ curl -fsSL https://revpi.dev/install.sh | sh

# Windows（PowerShell）
PS> irm https://revpi.dev/install.ps1 | iex

# macOS / Linux
$ curl -fsSL https://revpi.dev/install.sh | sh

# Windows (PowerShell)
PS> irm https://revpi.dev/install.ps1 | iex

也可以从源码构建：git clone https://github.com/revpidev/rpi.git && cd rpi && cargo build --release Or build from source: git clone https://github.com/revpidev/rpi.git && cd rpi && cargo build --release

2配置模型Configure a model

# 在 ~/.rpi/agent/models.json 里加入你的 Key（以 DeepSeek 为例）
{"providers": {"deepseek": {
  "apiKey": "DEEPSEEK_API_KEY",
  "models": [{"id": "deepseek-v4-flash"}]}}}

# Add your key in ~/.rpi/agent/models.json (DeepSeek example)
{"providers": {"deepseek": {
  "apiKey": "DEEPSEEK_API_KEY",
  "models": [{"id": "deepseek-v4-flash"}]}}}

3开始使用Start using it

$ rpi                        # 交互模式：边聊边改
$ rpi --print "重构这个函数"    # 一次性问答，适合脚本
$ rpi --mode rpc                  # RPC 模式：给其他程序调用

$ rpi                           # interactive: chat and edit
$ rpi --print "refactor this"   # one-shot, script-friendly
$ rpi --mode rpc                     # RPC mode for other programs

4（可选）关掉网络请求(Optional) Disable requests

# 不需要模型目录更新 / 版本检查时，逐项关闭：
$ export RPI_MODEL_CATALOG_URL=off
$ export RPI_VERSION_CHECK_URL=off
$ export RPI_TELEMETRY_URL=off

# Turn off catalog updates / version checks individually:
$ export RPI_MODEL_CATALOG_URL=off
$ export RPI_VERSION_CHECK_URL=off
$ export RPI_TELEMETRY_URL=off

Docs