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

# Deployments

> How a Zero Runtime agent runs in production - the runtime handles real-time media, and you deploy your agent to Zero Runtime Cloud with a single zrt up command.

Your agent runs as a **worker** - your code, wrapped by `zrt.serve(...)`. The Zero Runtime
**runtime** handles the real-time media (transport, GPUs, STT/LLM/TTS orchestration, and
turn-taking); your worker just registers with the runtime and receives sessions. You never
operate low-latency media infrastructure.

Everything here is driven by the `zrt` CLI. Install it with pip (Python 3.11+):

```bash theme={null}
pip install zrt
```

See [CLI Setup](/deployments/cli-setup) for authentication and next steps.

<Frame>
  <img src="https://mintcdn.com/zeroruntime/4_cfATkjcwT4WAC6/images/zrt-deployment-architecture.svg?fit=max&auto=format&n=4_cfATkjcwT4WAC6&q=85&s=f48407e27fdea9ba004e94fba04a454d" alt="Deployment architecture: a caller's live session reaches the Zero Runtime runtime, which manages transport, GPUs, and real-time media. The runtime streams the session to your agent worker, deployed on Zero Runtime Cloud via the CLI. The control plane invokes your agent to start the session." width="1500" height="560" data-path="images/zrt-deployment-architecture.svg" />
</Frame>

## How a session flows

1. A **caller** starts a live session (from a playground, a web/mobile client, or an
   inbound phone call).
2. The session reaches the **ZRT Runtime**, which Zero Runtime manages: transport, GPUs, and
   real-time media.
3. The **control plane** invokes your agent to start the session.
4. The runtime streams that session to one of your **registered workers**, which runs your
   agent code and responds back through the runtime.

## Deploying your agent

You deploy your agent to **Zero Runtime Cloud** with `zrt up`. Zero Runtime hosts, scales,
and runs your agent for you: it pulls your image and schedules the pods on **our** compute,
so you never operate a server. You manage everything (versions, secrets, sessions, and logs)
through the `zrt` CLI.

```bash theme={null}
zrt up
```

## Get started

<CardGroup cols={2}>
  <Card title="Install the CLI" icon="terminal" href="/deployments/cli-setup">
    Install `zrt` with pip and authenticate.
  </Card>

  <Card title="Deploy an Agent" icon="rocket" href="/deployments/deploy-an-agent">
    Create a project, test it locally, then deploy end to end.
  </Card>

  <Card title="Managing Deployments" icon="sliders" href="/deployments/managing-deployments">
    Versions, secrets, sessions, and logs.
  </Card>

  <Card title="CLI Reference" icon="book" href="/deployments/cli-reference">
    Every command and flag in one place.
  </Card>
</CardGroup>
