> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Rust Agent SDK Installation

> Install phaseo-agent and configure its Phaseo Gateway client.

## Requirements

* Rust 1.86 or newer
* a Phaseo Gateway API key

## Install

```toml theme={null}
[dependencies]
phaseo = "0.1"
phaseo-agent = "0.1"
serde_json = "1"
```

Or run:

```bash theme={null}
cargo add phaseo@0.1 phaseo-agent@0.1 serde_json
```

## Configure authentication

`create_gateway_agent_client(...)` and `GatewayAgentClient::from_env(...)` read `PHASEO_API_KEY`:

```bash theme={null}
export PHASEO_API_KEY="phaseo_v1_sk_..."
```

The underlying `phaseo` client also accepts an optional `PHASEO_BASE_URL`.

## Verify the installation

```rust theme={null}
use phaseo_agent::{create_agent, AgentDefinition};

fn main() {
    let _agent = create_agent(AgentDefinition::new(
        "verification-agent",
        "openai/gpt-5.6-sol",
    ));
    println!("Phaseo Rust Agent SDK installed");
}
```

## Next

* [Build your first Rust agent](./agent-sdk)
* [Tools and approvals](./agent-sdk-tools)
* [Agent API reference](./agent-sdk-api-reference)
