agent-sdk-rs

agent-sdk-rs is a lightweight Rust agent framework inspired by browser-use's SDK design.

It is intentionally minimal:

• small surface area
• explicit control flow
• simple tool integration
• easy embedding into Rust binaries

This project is expected to stay lightweight by default. New features should preserve that core philosophy.

What It Is

A Rust SDK for tool-using agents with:

• an Agent loop
• query + query_stream
• provider adapter boundary
• tool execution + dependency injection
• explicit completion semantics via done

Coverage (v0.1.0 alpha)

Implemented:

• Anthropic provider adapter (anthropic-ai-sdk)
• Google Gemini provider adapter (Google Generative Language API)
• xAI Grok provider adapter (xAI Chat Completions API)
• Agent + builder API
• query and query_stream
• event stream model (MessageStart, StepStart, ToolCall, ToolResult, FinalResponse, etc.)
• tool registration with JSON schema
• dependency map + dependency overrides
• translated Claude-code-style tool set:
  • bash, read, write, edit
  • glob_search, grep
  • todo_read, todo_write
  • done
• optional claude_code binary target

Out of scope right now:

• Laminar integration

Roadmap

Near-term:

1. Keep xAI/Anthropic/Google adapter trait behavior consistent
2. Keep adapter trait stable across providers
3. Improve docs/examples while keeping core small

Non-goal:

• turning this into a heavy orchestration framework

Documentation Status (Alpha)

• We currently focus docs on the core API surface (Agent, query APIs, provider adapters, tool primitives).
• If you enable missing_docs linting globally, you will see many warnings on secondary/public-for-now items.
• This crate is still alpha; some currently pub items exist for development convenience and may become private or reshaped before 1.0.

Install

[dependencies]
agent-sdk-rs = "0.1.0"

Quick Usage

1. Basic agent query

use agent_sdk_rs::{Agent, AnthropicModel};

let model = AnthropicModel::from_env("claude-sonnet-4-5")?;
let mut agent = Agent::builder().model(model).build()?;

let answer = agent.query("Hello").await?;
println!("{answer}");
# Ok::<(), Box<dyn std::error::Error>>(())

2. Google Gemini query

use agent_sdk_rs::{Agent, GoogleModel};

let model = GoogleModel::from_env("gemini-2.5-flash")?;
let mut agent = Agent::builder().model(model).build()?;

let answer = agent.query("Hello").await?;
println!("{answer}");
# Ok::<(), Box<dyn std::error::Error>>(())

3. Streaming events

use agent_sdk_rs::{Agent, AgentEvent, AnthropicModel};
use futures_util::StreamExt;

let model = AnthropicModel::from_env("claude-sonnet-4-5")?;
let mut agent = Agent::builder().model(model).build()?;

let stream = agent.query_stream("Solve this step by step");
futures_util::pin_mut!(stream);
while let Some(event) = stream.next().await {
    match event? {
        AgentEvent::ToolCall { tool, .. } => println!("tool: {tool}"),
        AgentEvent::FinalResponse { content } => println!("final: {content}"),
        _ => {}
    }
}
# Ok::<(), Box<dyn std::error::Error>>(())

4. xAI Grok query

use agent_sdk_rs::{Agent, GrokModel};

let model = GrokModel::from_env("grok-4-1-fast-reasoning")?;
let mut agent = Agent::builder().model(model).build()?;

let answer = agent.query("Hello").await?;
println!("{answer}");
# Ok::<(), Box<dyn std::error::Error>>(())

5. Claude-code tool pack

use agent_sdk_rs::tools::claude_code::{SandboxContext, all_tools};
use agent_sdk_rs::{Agent, AnthropicModel};

let model = AnthropicModel::from_env("claude-sonnet-4-5")?;
let sandbox = SandboxContext::create::<std::path::PathBuf>(None)?;

let mut agent = Agent::builder()
    .model(model)
    .tools(all_tools())
    .dependency(sandbox)
    .require_done_tool(true)
    .build()?;
# Ok::<(), Box<dyn std::error::Error>>(())

Optional Binary

Run the fun Claude-code-like binary:

cargo run --features claude-code --bin claude_code -- "list Rust files and summarize"

Environment:

• ANTHROPIC_API_KEY required
• ANTHROPIC_MODEL optional (default set in binary)
• GOOGLE_API_KEY or GEMINI_API_KEY required for Gemini
• XAI_API_KEY (or GROK_API_KEY) required for Grok
• CLAUDE_CODE_SANDBOX optional

Examples

cargo run --example local_loop
cargo run --example di_override

Releases (release-plz)

Releases are automated via GitHub Actions + release-plz.

• Workflow: .github/workflows/release-plz.yml
• Config: release-plz.toml
• Required secret: CARGO_REGISTRY_TOKEN

Behavior:

• feat:, fix:, perf:, refactor:, revert:, build: commits on main can trigger/update a release PR.
• docs: and chore: do not trigger a release PR by default.

Flow:

1. Merge releasable commits to main.
2. release-plz opens/updates a release PR.
3. Merge that release PR.
4. release-plz publishes crates, creates tags, and creates GitHub releases.

License

MIT. See LICENSE.