Get started | LiveKit Documentation

Overview

Follow these steps to deploy your first agent to LiveKit Cloud.

This guide assumes that you already have:

The latest version of the LiveKit CLI
A LiveKit Cloud project
A working agent. Create one using the Voice AI quickstart or one of the following starter templates:

A ready-to-deploy voice AI agent built with Python.

A ready-to-deploy voice AI agent built with Node.js.

Use the following steps with the LiveKit CLI to deploy your agent.

Navigate to your project directory:
```
cd your-agent-project
```
Authenticate with LiveKit Cloud:
```
lk cloud auth
```
This opens a browser window to link your LiveKit Cloud project to the CLI. If you've already authenticated and have linked projects, use lk project list to list all linked projects. Then, set the default project for agent deployment with lk project set-default "<project-name>".
Deploy your agent:
```
lk agent create
```
This registers your agent with LiveKit Cloud and assigns a unique ID. The ID is written to a new livekit.toml file along with the associated project and other default configuration. If you don't already have a Dockerfile, the CLI creates one for you.
Next, the CLI uploads your agent code to the LiveKit Cloud build service, builds an image from your Dockerfile, and then deploys it to your LiveKit Cloud project. See the Builds and Dockerfiles guide for details on the build process, logs, and templates.

Your agent is now deployed to LiveKit Cloud and is ready to handle requests. To connect, use the Agent Playground, custom frontend, or telephony integration.

Use the CLI to monitor the status and logs of your agent.

Monitor agent status:
```
lk agent status
```
This shows status, replica count, and other details for your running agent.
Tail agent logs:
```
lk agent logs
```
This shows a live tail of the logs for the new instance of your deployed agent.

Now that your agent is deployed, learn about: