Running Agents

Execute agent runs with streaming and non-streaming responses

1. Create a Python file

   run_agents.py

   import asyncio
   
   from agno.client import AgentOSClient
   from agno.run.agent import RunCompletedEvent, RunContentEvent
   
   
   async def run_agent_non_streaming():
       """Execute a non-streaming agent run."""
       print("=" * 60)
       print("Non-Streaming Agent Run")
       print("=" * 60)
   
       client = AgentOSClient(base_url="http://localhost:7777")
       
       # Get available agents
       config = await client.aget_config()
       if not config.agents:
           print("No agents available")
           return
   
       agent_id = config.agents[0].id
       print(f"Running agent: {agent_id}")
   
       # Execute the agent
       result = await client.run_agent(
           agent_id=agent_id,
           message="What is 2 + 2? Explain your answer briefly.",
       )
   
       print(f"\nRun ID: {result.run_id}")
       print(f"Content: {result.content}")
       print(f"Tokens: {result.metrics.total_tokens if result.metrics else 'N/A'}")
   
   
   async def run_agent_streaming():
       """Execute a streaming agent run."""
       print("\n" + "=" * 60)
       print("Streaming Agent Run")
       print("=" * 60)
   
       client = AgentOSClient(base_url="http://localhost:7777")
   
       # Get available agents
       config = await client.aget_config()
       if not config.agents:
           print("No agents available")
           return
   
       agent_id = config.agents[0].id
       print(f"Streaming from agent: {agent_id}")
       print("\nResponse: ", end="", flush=True)
   
       async for event in client.run_agent_stream(
           agent_id=agent_id,
           message="Tell me a short joke.",
       ):
           if isinstance(event, RunContentEvent):
               print(event.content, end="", flush=True)
           elif isinstance(event, RunCompletedEvent):
               pass
   
       print("\n")
   
   
   async def main():
       await run_agent_non_streaming()
       await run_agent_streaming()
   
   
   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. Supported Image Types

   AgentOS accepts the following image MIME types for uploads:

   Type	MIME
   PNG	image/png
   JPEG	image/jpeg, image/jpg
   WebP	image/webp
   HEIC	image/heic
   HEIF	image/heif

7. Run the Client

   Mac

   python run_agents.py