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

# 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

<CardGroup cols={2}>
  <Card title="AgentOS Client" icon="server" href="/agent-os/client/agentos-client">
    Connect to Agno AgentOS instances via REST API. Run agents, teams, workflows, manage sessions, knowledge, and memories.
  </Card>

  <Card title="A2A Client" icon="link" href="/agent-os/client/a2a-client">
    Connect to any A2A-compatible server including Agno, Google ADK, and other A2A implementations.
  </Card>
</CardGroup>

## 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:

```python theme={null}
import asyncio

from agno.client import AgentOSClient

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

    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")

asyncio.run(main())
```

### A2AClient

Best for cross-framework communication or connecting to A2A-compatible servers:

```python theme={null}
import asyncio

from agno.client.a2a import A2AClient

async def main():
    # Connect to an Agno A2A endpoint
    client = A2AClient("http://localhost:7003/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!")

asyncio.run(main())
```
