Skip to main content
Agno provides Python clients for programmatic access to agent servers. These clients enable you to run agents, manage sessions, and integrate AI capabilities into your applications.

​
Available Clients

AgentOS Client

Connect to Agno AgentOS instances via REST API. Run agents, teams, workflows, manage sessions, knowledge, and memories.

A2A Client

Connect to any A2A-compatible server including Agno, Google ADK, and other A2A implementations.

​
Choosing a Client

ClientUse Case
AgentOSClientConnect to Agno AgentOS instances with full feature access (sessions, knowledge, memories, traces)
A2AClientConnect to any A2A-compatible server for cross-framework agent communication

​
Quick Comparison

​
AgentOSClient

Best for connecting to Agno AgentOS instances where you need full access to all features: 
from agno.client import AgentOSClient

client = AgentOSClient(base_url="http://localhost:7777")

# Full AgentOS features
config = await client.aget_config()
result = await client.run_agent(agent_id="my-agent", message="Hello!")
sessions = await client.get_sessions(user_id="user-123")

​
A2AClient

Best for cross-framework communication or connecting to A2A-compatible servers: 
from agno.client.a2a import A2AClient

# Connect to Agno A2A endpoint
client = A2AClient("http://localhost:7001/a2a/agents/my-agent")
result = await client.send_message(message="Hello!")

# Or connect to Google ADK
client = A2AClient("http://localhost:8001/", protocol="json-rpc")
result = await client.send_message(message="Hello!")