Clients

Python clients for connecting to agent servers

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

Client	Use Case
AgentOSClient	Connect to Agno AgentOS instances with full feature access (sessions, knowledge, memories, traces)
A2AClient	Connect 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!")