> ## 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.

# Basic Team Factory

> Basic Team Factory -- per-tenant team with role-based members.

```python basic_team_factory.py theme={null}
"""Basic Team Factory -- per-tenant team with role-based members.

Demonstrates a TeamFactory that builds a team with different members
depending on the caller's context. The team mode and member composition
vary per request.

Run:
    .venvs/demo/bin/python cookbook/05_agent_os/factories/team/01_basic_team_factory.py

Test:
    curl -X POST http://localhost:7777/teams/support-team/runs \
        -F 'message=I need help with billing and a technical issue' \
        -F 'user_id=tenant_42' \
        -F 'stream=false'
"""

from agno.agent import Agent
from agno.db.postgres import PostgresDb
from agno.factory import RequestContext
from agno.models.openai import OpenAIResponses
from agno.os import AgentOS
from agno.team.factory import TeamFactory
from agno.team.team import Team

# ---------------------------------------------------------------------------
# Database
# ---------------------------------------------------------------------------

db = PostgresDb(
    id="team-factory-db",
    db_url="postgresql+psycopg://ai:ai@localhost:5532/ai",
)

# ---------------------------------------------------------------------------
# Factory
# ---------------------------------------------------------------------------


def build_support_team(ctx: RequestContext) -> Team:
    """Build a support team tailored to the calling tenant."""
    user_id = ctx.user_id or "anonymous"

    billing_agent = Agent(
        name="Billing Agent",
        role="Handle billing inquiries",
        model=OpenAIResponses(id="gpt-5.4"),
        instructions=f"You handle billing questions for tenant {user_id}. Be concise.",
    )

    tech_agent = Agent(
        name="Tech Support Agent",
        role="Handle technical issues",
        model=OpenAIResponses(id="gpt-5.4"),
        instructions=f"You handle technical support for tenant {user_id}. Be concise.",
    )

    return Team(
        name="Support Team",
        model=OpenAIResponses(id="gpt-5.4"),
        members=[billing_agent, tech_agent],
        db=db,
        instructions=[
            f"You are the support team leader for tenant {user_id}.",
            "Route billing questions to the Billing Agent and technical issues to the Tech Support Agent.",
        ],
        markdown=True,
    )


support_team_factory = TeamFactory(
    db=db,
    id="support-team",
    name="Per-tenant Support Team",
    description="Builds a support team with billing and tech agents per tenant",
    factory=build_support_team,
)

# ---------------------------------------------------------------------------
# AgentOS
# ---------------------------------------------------------------------------

agent_os = AgentOS(
    id="team-factory-demo",
    description="Demo: basic team factory",
    teams=[support_team_factory],
)
app = agent_os.get_app()

# ---------------------------------------------------------------------------
# Run
# ---------------------------------------------------------------------------

if __name__ == "__main__":
    agent_os.serve(app="01_basic_team_factory:app", port=7777, reload=True)
```

## Run the Example

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

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

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

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

  <Snippet file="run-pgvector-step.mdx" />

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

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

Full source: [cookbook/05\_agent\_os/factories/team/01\_basic\_team\_factory.py](https://github.com/agno-agi/agno/blob/main/cookbook/05_agent_os/factories/team/01_basic_team_factory.py)