Basic Client Usage

Connect to an AgentOS instance and inspect its agents, teams, and workflows

1. Create a Python file

   basic_client.py

   import asyncio
   
   from agno.client import AgentOSClient
   
   
   async def main():
       # Connect to AgentOS
       client = AgentOSClient(base_url="http://localhost:7777")
   
       # Get AgentOS configuration
       config = await client.aget_config()
       print(f"Connected to: {config.name or config.os_id}")
       print(f"Available agents: {[a.id for a in (config.agents or [])]}")
       print(f"Available teams: {[t.id for t in (config.teams or [])]}")
       print(f"Available workflows: {[w.id for w in (config.workflows or [])]}")
   
       # Get details about a specific agent
       if config.agents:
           agent_id = config.agents[0].id
           agent = await client.aget_agent(agent_id)
           print("\nAgent Details:")
           print(f"  Name: {agent.name}")
           print(f"  Model: {agent.model}")
           print(f"  Tools: {len(agent.tools or [])}")
   
   
   if __name__ == "__main__":
       asyncio.run(main())
   
2. Set up your virtual environment

   Mac

   uv venv --python 3.12
   source .venv/bin/activate
   

   uv venv --python 3.12
   .venv\Scripts\activate
   
3. Install dependencies

   uv pip install -U "agno[os]" openai
   
4. Export your OpenAI API key

   Mac/Linux

   export OPENAI_API_KEY="your_openai_api_key_here"
   

   $Env:OPENAI_API_KEY="your_openai_api_key_here"
   
5. Start an AgentOS Server

   Start the client example server on port 7777. It registers the agents, team, and workflow used by these client examples.

6. Run the Client

   Mac

   python basic_client.py
   

   python basic_client.py