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

# Running Agents

> Execute agent runs with streaming and non-streaming responses

<Steps>
  <Step title="Create a Python file">
    ```python run_agents.py theme={null}
    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())
    ```
  </Step>

  <Snippet file="create-venv-step.mdx" />

  <Step title="Install dependencies">
    ```bash theme={null}
    uv pip install -U agno openai
    ```
  </Step>

  <Step title="Export your OpenAI API key">
    <CodeGroup>
      ```bash Mac/Linux theme={null}
      export OPENAI_API_KEY="your_openai_api_key_here"
      ```

      ```bash Windows theme={null}
      $Env:OPENAI_API_KEY="your_openai_api_key_here"
      ```
    </CodeGroup>
  </Step>

  <Step title="Start an AgentOS Server">
    Make sure you have an AgentOS server running on port 7777. See [Creating Your First OS](/agent-os/run-your-os) for setup instructions.
  </Step>

  <Step title="Run the Client">
    <CodeGroup>
      ```bash Mac theme={null}
      python run_agents.py
      ```

      ```bash Windows theme={null}
      python run_agents.py
      ```
    </CodeGroup>
  </Step>
</Steps>