> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Nexus Basic

> Run Claude Sonnet 4 through the Nexus gateway, sync and async, with streaming.

> [!WARNING]
>
> The source routes requests to Anthropic's retired `claude-sonnet-4-20250514` model. Replace it with `anthropic/claude-sonnet-4-6` before running. See [Anthropic model deprecations](https://platform.claude.com/docs/en/about-claude/model-deprecations).

```python basic.py theme={null}
"""
Nexus Basic
===========

Cookbook example for `nexus/basic.py`.
"""

from agno.agent import Agent, RunOutput  # noqa
from agno.models.nexus import Nexus
import asyncio

# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------

agent = Agent(model=Nexus(id="anthropic/claude-sonnet-4-20250514"), markdown=True)

# Get the response in a variable
# run: RunOutput = agent.run("Share a 2 sentence horror story")
# print(run.content)

# Print the response in the terminal

# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------
if __name__ == "__main__":
    # --- Sync ---
    agent.print_response("Share a 2 sentence horror story")

    # --- Sync + Streaming ---
    agent.print_response("Share a 2 sentence horror story", stream=True)

    # --- Async ---
    asyncio.run(agent.aprint_response("Share a 2 sentence horror story"))

    # --- Async + Streaming ---
    asyncio.run(agent.aprint_response("Share a 2 sentence horror story", stream=True))
```

## Run the Example

<Snippet file="create-venv-step.mdx" />

**1. Install dependencies**

```bash theme={null}
uv pip install -U agno openai
```

**2. Export your API keys**

```bash Mac/Linux theme={null}
export ANTHROPIC_API_KEY="your_anthropic_api_key_here"
export OPENAI_API_KEY="your_openai_api_key_here"
```

```bash Windows theme={null}
$Env:ANTHROPIC_API_KEY="your_anthropic_api_key_here"
$Env:OPENAI_API_KEY="your_openai_api_key_here"
```

**3. Use a current Claude model**

Replace `anthropic/claude-sonnet-4-20250514` with `anthropic/claude-sonnet-4-6` in the saved file.

**4. Configure Nexus**

[Install Nexus](https://nexusrouter.com/docs/installation), then create `nexus.toml` for the Anthropic model and the `/llm/v1/` endpoint used by Agno:

```bash theme={null}
cat > nexus.toml <<'TOML'
[server]
listen_address = "127.0.0.1:8000"

[llm]
enabled = true

[llm.protocols.openai]
enabled = true
path = "/llm"

[llm.providers.anthropic]
type = "anthropic"
api_key = "{{ env.ANTHROPIC_API_KEY }}"

[llm.providers.anthropic.models."claude-sonnet-4-6"]
TOML
```

**5. Start Nexus**

Start the gateway from the directory that contains `nexus.toml`:

```bash theme={null}
nexus
```

**6. Run the example**

Save the code above as `basic.py`, then run:

```bash theme={null}
python basic.py
```

Full source: [cookbook/90\_models/nexus/basic.py](https://github.com/agno-agi/agno/blob/v3.0.4/cookbook/90_models/nexus/basic.py)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.