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

# Serve a Workflow with AgentOS

> Serve one two-step workflow as an HTTP resource.

Serve one two-step workflow as an HTTP resource. AgentOS adds discovery, execution, streaming, persisted-run, and WebSocket routes around the workflow.

```python basic.py theme={null}
"""
Serve a Workflow with AgentOS
=============================

Serve one two-step workflow as an HTTP resource. AgentOS adds discovery,
execution, streaming, persisted-run, and WebSocket routes around the workflow.

Prerequisites: OPENAI_API_KEY
Run: .venvs/demo/bin/python cookbook/05_agent_os/09_serving_workflows/basic.py
Try: Run run_over_api.py or ws_stream.py from this folder in another terminal
"""

from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.models.openai import OpenAIResponses
from agno.os import AgentOS
from agno.workflow import Step, Workflow

# ---------------------------------------------------------------------------
# Create Served Workflow
# ---------------------------------------------------------------------------

WORKFLOW_ID = "release-notes-workflow"

db = SqliteDb(
    id="serving-workflows-db",
    db_file="tmp/serving_workflows.db",
)

draft_agent = Agent(
    id="release-notes-drafter",
    name="Release Notes Drafter",
    model=OpenAIResponses(id="gpt-5.5"),
    instructions=(
        "Turn the request into a concise release-note draft with a heading and "
        "three short bullets."
    ),
)

editor_agent = Agent(
    id="release-notes-editor",
    name="Release Notes Editor",
    model=OpenAIResponses(id="gpt-5.5"),
    instructions=(
        "Edit the preceding draft for clarity. Return only the final heading "
        "and three short bullets."
    ),
)

release_notes_workflow = Workflow(
    id=WORKFLOW_ID,
    name="Release Notes Workflow",
    description="Draft and edit concise release notes in two steps.",
    db=db,
    steps=[
        Step(name="Draft Release Notes", agent=draft_agent),
        Step(name="Edit Release Notes", agent=editor_agent),
    ],
)

agent_os = AgentOS(
    id="serving-workflows-os",
    description="AgentOS serving a two-step workflow.",
    db=db,
    workflows=[release_notes_workflow],
)
app = agent_os.get_app()

# ---------------------------------------------------------------------------
# Run Workflow Server
# ---------------------------------------------------------------------------

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

## Run the Example

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

  <Step title="Install dependencies">
    ```bash theme={null}
    uv pip install -U "agno[os]" 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="Run the example">
    Save the code above as `basic.py`, then run:

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

Full source: [cookbook/05\_agent\_os/09\_serving\_workflows/basic.py](https://github.com/agno-agi/agno/blob/v3.0.4/cookbook/05_agent_os/09_serving_workflows/basic.py)