> ## 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 zeroruntime up command.

Your agent runs as a **worker** - your code, wrapped by `zeroruntime.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 `zeroruntime` CLI, installed with the `zeroruntime` package (Python 3.11+):

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

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

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/zeroruntime/images/zeroruntime-deployment-architecture.svg" 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." />
</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 **Zero 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 `zeroruntime 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 `zeroruntime` CLI.

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

## Get started

<CardGroup cols={2}>
  <Card title="Install the CLI" icon="terminal" href="/deployments/cli-setup">
    Install the `zeroruntime` package 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>
