Zeltro › Como rodar um projeto do v0 localmente

Rodando um projeto do v0 no seu próprio computador

Dá para rodar o v0 localmente? O criador não, o seu projeto sim. Como tirar um app do v0 pelo GitHub, rodar o código Next.js no seu próprio computador, levar junto as variáveis de ambiente e o banco de dados, e continuar construindo com a sua própria IA.

"Rodar o v0 localmente" pode significar duas coisas.

O v0 em si não roda localmente. Ele é o agente hospedado da Vercel: seu projeto roda em um Vercel Sandbox na nuvem, com os modelos do v0 e a cobrança do v0.

O seu projeto do v0 roda. O FAQ do v0 responde direto: "Exporte o código para trabalhar localmente ou edite direto no v0." O que você recebe é um app Next.js padrão, nas palavras do v0 "Next.js, React, TypeScript, Tailwind CSS e shadcn/ui". Esta página fala de rodar esse app no seu próprio computador e continuar construindo por lá.

v0Onde o app foi criado
GitHubSettings → GitHub → Connect
Seu computadorNext.js no Node 22
Sua IAContinua construindo, sem créditos

O que é um projeto do v0#

Parte O que é Vem junto com o código?
App Next.js com React, TypeScript, Tailwind e shadcn/ui Sim
Variáveis de ambiente Definidas no v0 em Settings → Environment Variables Não
Banco de dados Uma integração do Vercel Marketplace: Neon, Supabase, Upstash ou Vercel Blob Não; é um serviço na nuvem ao qual o app se conecta
Hospedagem Vercel Não

A boa notícia está na primeira linha. Um app Next.js é uma coisa bem comum de rodar.

Passo 1: tire o código do v0 pelo GitHub#

O GitHub é o caminho que o v0 documenta, e ele continua funcionando depois que você começa a editar localmente.

  1. No v0, abra Project menu (…) → Settings → GitHub e escolha Connect.
  2. Escolha uma conta ou organização, dê um nome ao repositório e escolha Create Repository.
  3. O v0 "cria um repositório privado e envia para ele o código atual do projeto".

A partir daí, cada chat do v0 trabalha no seu próprio branch, e publicar faz o merge dele no branch base por um pull request. Para trazer os seus próprios commits para o branch de um chat, use Pull Changes no v0. Alguns guias também descrevem um download em ZIP pelo menu do projeto; o GitHub é o caminho certo se você pretende continuar.

Passo 2: rode o projeto do v0 localmente#

A versão rápida, se você só quer ver rodando:

  1. Instale o Node.js.
  2. Faça git clone do repositório e entre nele com cd.
  3. Rode npm install e depois npm run dev.

Ele vai subir, e aí qualquer página que precise de um banco de dados ou de uma chave de API vai falhar, porque as variáveis de ambiente ficaram no v0. Esse é o passo 3.

Para continuar construindo, um ambiente de verdade ajuda. O Zeltro é uma plataforma de desenvolvimento local gratuita: cada projeto roda no seu próprio contêiner com Node 22, todos os projetos compartilham um conjunto de bancos de dados, e o seu agente de IA trabalha dentro do projeto.

zeltro clone work-directly https://github.com/you/your-v0-app

O Zeltro lê o package.json, vê que é Next.js e configura o projeto no Node 22, servido pelo nginx na porta 80. Com um agente de IA configurado, o clone também pede a ele que adapte o repositório ao Zeltro. O zeltro status your-v0-app mostra o endereço, e um endereço de rede local para testar no celular.

O Next.js 16 recusa conexões de hot reload de hosts que ele não conhece. Os projetos Next.js do próprio Zeltro listam as faixas de IPv4 privadas em allowedDevOrigins no next.config. Se a página carrega mas não atualiza quando você salva, adicione isso, ou peça ao seu agente.

O app Zeltro: uma barra lateral de projetos, cada um com indicador de execução, seus endereços local e de rede local, e botões para iniciar, parar, editar e abrir
Um projeto entre vários, cada um com seu próprio endereço.

Passo 3: variáveis de ambiente e o banco de dados#

O v0 guarda as variáveis de ambiente por ambiente (Production, Preview e Development), e a documentação dele diz que o conjunto Development é o que é "aplicado ao painel de prévia do v0 ou quando roda localmente". Copie esses valores para um .env.local no projeto. Se o projeto estiver vinculado a um projeto da Vercel, o vercel env pull da CLI da Vercel escreve tudo para você.

As integrações de banco de dados são serviços na nuvem, então continuam funcionando a partir do seu computador assim que as variáveis estiverem no lugar. Aí você escolhe:

Opção 1

Manter na nuvem

Neon, Supabase ou Upstash ficam onde estão, e o seu app local conversa com eles. É simples, mas as mudanças locais mexem em dados reais, então use um branch de desenvolvimento ou um banco de dados separado.

Opção 2

Trazer para o seu computador

O Neon é Postgres e o Upstash é Redis, e o Zeltro já roda os dois para todos os projetos. Faça um dump dos dados, carregue no zeltro-postgres compartilhado, aponte a DATABASE_URL para ele e desenvolva off-line com a sua própria cópia. Seu agente pode fazer esse passo.

Configurações do Zeltro, aba Serviços compartilhados: zeltro-mariadb, zeltro-redis, zeltro-memcached e phpMyAdmin rodando, cada um com seu endereço
Os serviços compartilhados, entre eles o Redis. O Postgres sobe quando um projeto precisa dele.

Passo 4: continue construindo, com a sua própria IA#

O v0 cobra pelo uso dos próprios modelos. Quando o app roda localmente, o agente pode ser seu: Claude Code, Codex, Antigravity, Qwen Code, Aider, OpenCode ou Hermes, com uma assinatura que você já paga, uma chave de API pelo preço do próprio fornecedor ou um modelo local gratuito.

cd ~/zeltro-projects/your-v0-app
zeltro ai "read AGENTS.md, then add a search box to the products page"

Todo projeto tem um AGENTS.md que descreve o endereço, o banco de dados e os comandos, então o agente já começa sabendo onde está. Veja traga sua própria chave, ou coloque os seus próprios números na calculadora de economia.

Você ainda pode usar o v0 junto: envie o seu branch e puxe para um chat do v0 com Pull Changes.

O app Zeltro com uma sessão do Claude Code ao lado da lista de projetos, que acabou de adicionar uma caixa de busca a um app de receitas e lista os arquivos que alterou
Seu próprio agente trabalhando, no seu próprio plano, ao lado dos seus projetos.

Bom saber#

O Zeltro não hospedaA Vercel publica um projeto do v0 com um clique, e continua podendo: enviar para o GitHub não impede isso. O Zeltro é onde você constrói. Se preferir hospedar em um lugar que você controla, eu coloco no ar para você.

Nem todo projeto do v0 é só Next.jsO v0 pode gerar código que depende de serviços da Vercel, como o AI Gateway ou o armazenamento Blob. Eles continuam funcionando com as variáveis de ambiente certas, e são as partes a substituir se você quiser sair da Vercel de vez.

Fontes#

Verificado em 18 de outubro de 2026: as páginas do v0 de FAQs, GitHub, bancos de dados e sandbox. Os recursos mudam, então confira na sua própria conta.

Perguntas

Posso rodar o v0 localmente?

O criador, não: o v0 roda na nuvem da Vercel. O seu projeto do v0, sim. Conecte-o ao GitHub, clone o repositório e rode npm install e npm run dev.

Como rodo um projeto do v0 localmente?

Conecte o projeto ao GitHub em Settings → GitHub, clone o repositório, instale o Node.js e rode npm install e depois npm run dev. Copie as variáveis de ambiente de Development do v0 para o .env.local, ou use vercel env pull.

Como baixo o código do v0?

Conecte o GitHub e o v0 envia o código do projeto para um repositório privado na sua conta. É o método que o v0 documenta, e ele fica sincronizado. Você também pode baixar arquivos individuais pelo visualizador de código.

Um projeto do v0 inclui o banco de dados?

Não. Os bancos de dados do v0 são integrações do Vercel Marketplace (Neon, Supabase, Upstash, Vercel Blob) que rodam na nuvem. A sua cópia local se conecta a eles pelas variáveis de ambiente, ou você pode levar os dados para um Postgres ou Redis local.

Existe uma alternativa ao v0 que roda localmente?

O Zeltro roda no seu próprio computador com o seu próprio agente de IA, e cria apps em PHP e Python, além de Next.js e outros frameworks JavaScript. Veja a comparação completa dos criadores de apps com IA.

Quanto custa o Zeltro?

O app Zeltro é grátis para uso pessoal, projetos por hobby e aprendizado, sem conta. Uma empresa que o usa, inclusive em trabalhos pagos para clientes, compra uma licença comercial vitalícia uma única vez, por US$99.99. A ferramenta de linha de comando zeltro é de código aberto (MIT). À parte, você paga pela sua IA: uma assinatura que já tem, uma chave de API cobrada por uso, ou nada com um modelo local.

Continue construindo seu app do v0 localmente

Instale o Zeltro, clone seu repositório do v0 e continue construindo com a IA que você já paga, ou com um modelo local gratuito. Grátis para uso pessoal, sem conta.

Instalar o Zeltro Por que trazer sua própria chave

Prefere não configurar você mesmo? Eu faço para você.

Verificado em 2026-10-18. Os outros produtos mudam com frequência: se algo aqui estiver desatualizado, avise a gente e a gente corrige.