Practical overview
When it fits
Use rpi when you want a Rust-based agent runtime that can serve both as a terminal CLI and as an embeddable library, with tools and plugin support shared across those modes.
Who it is for
- Developers who want a terminal-based coding agent.
- Rust developers building an agent into their own application.
- Plugin authors extending tools or providers across rpi sessions.
Documented uses
- Run an interactive or one-shot coding-agent prompt from a terminal.
- Embed an agent runtime in a Rust process and handle its events.
- Configure Anthropic or OpenAI-compatible providers, including a custom gateway.
- Preserve agent sessions as JSONL and resume from the last committed frame after a crash.
- Build tools for an embedded agent and package them as CLI-loaded plugins.
Requirements & limits
The repository is public and MIT-licensed. The README documents prebuilt-binary, Cargo, package-manager and source installation routes; Cargo installation requires Rust 1.78 or later.
- The project supports both a ready-to-run CLI and an embeddable Rust library.
- The documented provider options include Anthropic, OpenAI and OpenAI-compatible gateways.
- A faux provider supports deterministic SDK examples without an API key or network connection.
- CLI sessions use JSONL storage and are described as crash-resumable.
- The prebuilt binary installer is documented as avoiding the need for a Rust toolchain; Cargo installation requires Rust 1.78 or later.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install rpi from crates.io
Install the rpi terminal CLI using Cargo.
Before you start
- Rust 1.78 or later.
Steps
Run the command below.
cargo install rpi-cliRun
rpi --versionto display the installed CLI version.
Expected outcome
The rpi CLI is installed through Cargo and its version can be displayed.
Guide limitations
- This installation route requires Rust 1.78 or later.
Start an interactive rpi session
Launch the terminal agent using a configured provider.
Before you start
- An Anthropic or OpenAI API key, or provider configuration in
~/.rpi/agent/models.json.
Steps
Set
ANTHROPIC_API_KEYorOPENAI_API_KEY, or configure a provider in~/.rpi/agent/models.json.Run
rpito open the interactive terminal interface.
Expected outcome
The terminal agent opens with the configured provider.
Guide limitations
- The README documents Anthropic and OpenAI-compatible providers; provider-specific model access depends on the chosen configuration.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 7 October 2026
- Original website title
- bigfish1913/pi-rust · Official homepage title · retained in its source language

