---
title: Install Voila
description: Install the Voila CLI and upload a video for sharing and review.
canonical: https://voila.show/install
last-updated: 2026-09-12
---

# Install Voila

Install the CLI once, give it your token, and your agent can upload videos.

## Step 1: Install

The CLI requires Node 20+ or Bun 1.4+.

```sh
bun add --global @voilashow/cli
```

```sh
npm install --global @voilashow/cli
```

```sh
pnpm add --global @voilashow/cli
```

```sh
yarn global add @voilashow/cli
```

## Step 2: Token

[Generate an API token in Settings](/settings), then put it in your agent's
environment as `VOILA_API_TOKEN`:

```sh
export VOILA_API_TOKEN=your-token
```

## Step 3: Video proof

Example prompt:

> Fix this issue: https://github.com/your-org/your-repo/issues/123. First
> reproduce it with a failing test and make a video showing the bug. Upload that
> video to Voila. Then fix the issue, make a second video showing the fix, and
> upload it as a revision of the first video.

## Next

Read the [agent guide](/llms.txt).