basic.py
Run the Example
1
Set up your virtual environment
2
Install dependencies
3
Export your OpenRouter API key
4
Run the example
Save the code above as
basic.py, then run:Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Run openai/gpt-oss-20b through OpenRouterResponses with reasoning enabled in sync and async modes.
"""Basic example using OpenRouter with the Responses API.
OpenRouter's Responses API (beta) provides OpenAI-compatible access to multiple
AI models through a unified interface.
Requirements:
- Set OPENROUTER_API_KEY environment variable
"""
import asyncio
from agno.agent import Agent
from agno.models.openrouter import OpenRouterResponses
# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------
agent = Agent(
model=OpenRouterResponses(id="openai/gpt-oss-20b", reasoning={"enabled": True}),
markdown=True,
)
# Print the response in the terminal
# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------
if __name__ == "__main__":
# --- Sync ---
agent.print_response("Share a 2 sentence horror story")
# --- Async ---
asyncio.run(agent.aprint_response("Share a 2 sentence horror story"))
Set up your virtual environment
uv venv --python 3.12
source .venv/bin/activate
uv venv --python 3.12
.venv\Scripts\activate
Install dependencies
uv pip install -U agno openai
Export your OpenRouter API key
export OPENROUTER_API_KEY="your_openrouter_api_key_here"
$Env:OPENROUTER_API_KEY="your_openrouter_api_key_here"
Run the example
basic.py, then run:python basic.py
Was this page helpful?