> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agno.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Server

> Serve the AgentOS used by every Python client example in this folder.

```python _server.py theme={null}
"""Serve the AgentOS used by every Python client example in this folder.

The server exposes one agent, one team, one workflow, and one knowledge base
on port 7778. Set OS_SECURITY_KEY before starting it to enable Bearer auth.

Prerequisites: OPENAI_API_KEY for model, embedding, and evaluation calls.
Run: .venvs/demo/bin/python cookbook/05_agent_os/03_python_client/_server.py
Try: open http://localhost:7778/docs after the server starts.
"""

import os

from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.knowledge.embedder.openai import OpenAIEmbedder
from agno.knowledge.knowledge import Knowledge
from agno.models.openai import OpenAIResponses
from agno.os import AgentOS
from agno.os.settings import AgnoAPISettings
from agno.team import Team
from agno.tools.calculator import CalculatorTools
from agno.vectordb.chroma import ChromaDb
from agno.workflow import Step, Workflow

# ---------------------------------------------------------------------------
# Create the AgentOS
# ---------------------------------------------------------------------------

db = SqliteDb(db_file="tmp/python_client.db")

knowledge = Knowledge(
    name="Python Client Knowledge",
    contents_db=db,
    vector_db=ChromaDb(
        collection="python_client_knowledge",
        path="tmp/python_client_chromadb",
        persistent_client=True,
        embedder=OpenAIEmbedder(id="text-embedding-3-small"),
    ),
)

assistant = Agent(
    id="assistant",
    name="Assistant",
    model=OpenAIResponses(id="gpt-5.5"),
    instructions=[
        "Answer clearly and concisely.",
        "Use the calculator for arithmetic.",
        "Search the knowledge base when the user asks about uploaded content.",
    ],
    tools=[CalculatorTools()],
    knowledge=knowledge,
    search_knowledge=True,
)

research_team = Team(
    id="research-team",
    name="Research Team",
    model=OpenAIResponses(id="gpt-5.5"),
    members=[assistant],
    instructions="Delegate questions to the assistant and return a concise answer.",
)

qa_workflow = Workflow(
    id="qa-workflow",
    name="QA Workflow",
    steps=[Step(name="Answer", agent=assistant)],
)

agent_os = AgentOS(
    id="python-client-demo",
    name="Python Client Demo",
    description="AgentOS server for the Python client cookbook.",
    db=db,
    agents=[assistant],
    teams=[research_team],
    workflows=[qa_workflow],
    knowledge=[knowledge],
    settings=AgnoAPISettings(os_security_key=os.getenv("OS_SECURITY_KEY")),
)
app = agent_os.get_app()

# ---------------------------------------------------------------------------
# Run the Server
# ---------------------------------------------------------------------------

if __name__ == "__main__":
    agent_os.serve(app=app, port=7778)
```

## Run the Example

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

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

  <Step title="Export environment variables">
    <CodeGroup>
      ```bash Mac/Linux theme={null}
      export OPENAI_API_KEY="your_openai_api_key_here"
      export OS_SECURITY_KEY="your_os_security_key_here"
      ```

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

  <Step title="Run the example">
    Save the code above as `_server.py`, then run:

    ```bash theme={null}
    python _server.py
    ```
  </Step>
</Steps>

Full source: [cookbook/05\_agent\_os/03\_python\_client/\_server.py](https://github.com/agno-agi/agno/blob/v3.0.4/cookbook/05_agent_os/03_python_client/_server.py)