rig

• Everything is a plugin. The agent is a Bevy app; its tools, commands, sessions, sign-in and terminal view are each a plugin, turned on or off in settings.toml, so any of them can be removed, replaced or added to.
• It rebuilds itself. /reload rebuilds the agent with your plugin crates and restarts it in the same session, and keeps the old build running if the new one does not compile.
• Scriptable. rig -p --json and rig --json drive it over pipes; rig help-agents is the protocol.
• More when you want it. Subagents are an optional plugin, and the tools work on remote hosts over ssh or any command.

The agent guide covers the keys, sessions, compaction, plugins and files, and the plugin guide shows how to write a tool, command or panel. The agent needs Rust 1.97.1 or newer and runs on Linux and macOS.

The library

cargo add rig

use rig::prelude::*;
use rig::providers::openai::{self, OpenAI};

#[tokio::main]
async fn main() -> Result<(), anyhow::Error> {
    // The client reads `OPENAI_API_KEY` and builds the models it serves.
    let model = OpenAI::from_env()?.completion(openai::GPT_6_1_SOL);
    let comedian = AgentBuilder::new(model)
        .preamble("You are a comedian here to entertain the user using humour and jokes.")
        .build();

    let response = comedian.prompt("Entertain me!").await?;
    println!("{}", response.output());
    Ok(())
}

#[tokio::main] needs tokio's macros and rt-multi-thread features (cargo add tokio --features macros,rt-multi-thread).

• 20+ model providers and 10+ vector stores, each under one interface
• Agents with tools, multi-turn streaming and typed hooks
• Completion, embedding, transcription, audio and image generation
• GenAI semantic conventions for OpenTelemetry
• Recording and replay of an agent's effects (rig-cassette)
• Browser WASM (wasm32-unknown-unknown) for the core and the agent runtime (target support)

More in examples/, the docs and the API reference.

rig-core no longer forces serde_json's preserve_order or float_roundtrip features. Without them, JSON object keys sort by name, including schema properties and JSON text embedded in prompts, embeddings and tool results. Parsing floating-point numbers can change their low bits. To restore the previous configuration, add this to your application's Cargo.toml dependencies:

serde_json = { version = "1", features = ["preserve_order", "float_roundtrip"] }

Cargo unifies features across dependencies. rig-cassette with traffic (and therefore rig-traffic) still enables both features. rig-claude-cloak, rig-mcp-client and rig-mongodb through BSON still enable preserve_order. These are application-level serde_json choices; Rig has no forwarding feature.

Crates

The rig crate re-exports the core and the agent runtime, and each companion crate behind a feature.

Integrations

rig = { version = "0.46.0", features = ["lancedb", "fastembed"] }

Community

Projects built on Rig are listed in awesome-rig; open a pull request there to add yours. Questions and ideas are welcome on Discord, and CONTRIBUTING.md says how to contribute. Rig is MIT licensed.

[!WARNING] Rig is pre-1.0. Releases contain breaking changes; each release's changelog and migration notes say what changed and how to move.