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

# Cloud quickstart

> Run an agent through the Veryfront Cloud AI Gateway and deploy it.

Build an agent app, use the Veryfront Cloud AI Gateway during local development
and evaluation, then deploy the same source to Veryfront Cloud.

## Prerequisites

* Node.js 22.3 or later.
* A Veryfront account.

You do not need a model-provider API key for this tutorial.

## Create the app

```bash theme={null}
npm create veryfront@latest support-agent -- --template ai-agent
cd support-agent
```

## Sign in and link the project

```bash theme={null}
npx veryfront@latest login
npx veryfront@latest push
```

Sign-in stores the CLI credential. Push creates or links the Cloud project and
prints its protected preview URL.

## Run through the AI Gateway

```bash theme={null}
npm run dev
```

The CLI confirms the gateway is available:

```text theme={null}
✓ Ready in 1.3s
http://localhost:3000
Inference Veryfront Cloud AI Gateway
```

## Verify the agent locally

Open the local URL printed by the CLI and ask:

```text theme={null}
What is 128 divided by 8?
```

The assistant calls the calculator tool and returns `16` through the Veryfront
Cloud AI Gateway.

## Run the eval

Stop the dev server with `Ctrl+C`, then run:

```bash theme={null}
npm run eval -- assistant
```

The command exits successfully after the agent calls the calculator and returns
the expected answer through the gateway.

## Deploy to production

```bash theme={null}
npx veryfront@latest deploy --env production
```

Deploy uses the source from Push and prints the production environment URL.
Veryfront Cloud environments are protected by default, so open the URL in a
browser signed in as a project member.

## Verify it worked

Open the production URL that Deploy printed and ask the same calculator
question. The deployed agent returns `16` through the Veryfront Cloud AI
Gateway.

## Next steps

* [Deploy an existing project](/docs/code/getting-started/deploy-project).
* [Choose an explicit gateway model](/docs/code/guides/providers#veryfront-cloud-ai-gateway).
* [Review deployment behavior](/docs/code/guides/deploying).
* [Develop without Veryfront Cloud](/docs/code/getting-started/quickstart).