Basic Client Usage

Connect to an AgentOS instance and perform basic operations

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
   
3. Install dependencies

   uv pip install -U agno openai
   
4. Export your OpenAI API key

   Mac/Linux

   export OPENAI_API_KEY="your_openai_api_key_here"
   
5. Start an AgentOS Server

   Make sure you have an AgentOS server running on port 7777. See Creating Your First OS for setup instructions.

6. Run the Client

   Mac

   python basic_client.py