Zeltro › Rode seu app do Emergent no seu próprio computador

Como rodar um app do Emergent localmente

O Emergent exporta um código de verdade, com React ou Next, FastAPI ou Node, e MongoDB. Colocar isso para rodar localmente dá mais trabalho do que um zip simples de React. Veja o que vem na exportação e como fazer tudo funcionar.

O Emergent é um dos mais abertos entre os criadores de apps por prompt: ele gera uma aplicação de verdade que você pode baixar, e do plano Standard para cima o repositório fica na sua própria conta do GitHub, não na deles.

O problema é que uma aplicação de verdade é mais do que um front end. Um projeto do Emergent costuma ter React ou Next.js na frente, FastAPI ou Node atrás e MongoDB por baixo, com Expo para o celular. Descompactar isso e rodar npm install leva você só até um terço do caminho.

Esta página trata dos outros dois terços.

EmergentOnde o app foi criado
GitHub ou zipSeu próprio repositório, do Standard para cima
Seu computadorPython, Node e MongoDB, já prontos
Sua IAContinua construindo, sem cobrança por prompt

Com o que você está lidando#

Front end

  • NormalmenteReact, Next.js ou Expo
  • Precisa localmenteNode

Back end

  • NormalmenteFastAPI (Python) ou Node
  • Precisa localmentePython 3 com os pacotes certos, ou Node

Banco de dados

  • NormalmenteMongoDB
  • Precisa localmenteUma instância do Mongo rodando e uma string de conexão

Uma exportação de uma linguagem só, como um zip do Bolt ou do Lovable, roda de verdade com npm install && npm run dev. Uma exportação com várias linguagens e um banco de dados não roda, e é aí que as pessoas empacam.

O caminho manual#

Vale conhecer, porque para uma vez só ele resolve, e você não deve instalar nada de que não precisa:

  1. Instale o Node e o Python 3

    Nas versões que o projeto espera.

  2. Rode o MongoDB

    Instale e rode, ou crie uma instância hospedada no Atlas.

  3. Prepare o Python

    Crie um virtualenv e rode pip install -r requirements.txt.

  4. Escreva um .env

    Descubra quais variáveis de ambiente o backend espera.

  5. Rode as duas metades

    Rode a API e o front end em terminais separados, um apontando para o outro.

Nada disso é difícil. São só cinco coisas, cada uma com seu próprio jeito de dar errado, e você repete a sequência inteira no próximo projeto.

O caminho com o Zeltro#

O Zeltro é um ambiente de desenvolvimento local que já tem essas peças prontas. Python 3 e Node 22 são imagens base com os drivers já compilados, e o MongoDB é um dos serviços compartilhados que qualquer projeto pode usar.

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

Isso baixa o repositório, detecta a stack, cria o projeto, conecta ao MongoDB compartilhado, grava as credenciais no .env e dá um endereço ao projeto. O zeltro status mostra esse endereço: um local, para este computador, e um de rede local, para todo o resto.

O app Zeltro: uma barra lateral de projetos de demonstração, cada um com indicador de execução, seus endereços local e de rede local, e botões para iniciar, parar, editar e abrir
Cada projeto ganha um endereço e um indicador de execução. O próximo app que você trouxer fica logo ao lado.

Se você baixou um zip em vez de usar a integração com o GitHub, aponte o Zeltro para a pasta descompactada:

zeltro setup your-emergent-app

O MongoDB compartilhado é o que mais economiza tempo aqui, e continua economizando. O segundo e o terceiro app que você trouxer usam a mesma instância: nada de instalar outro banco de dados ou escolher outra porta.

Depois que estiver rodando#

Agora você tem um projeto comum no seu disco, então um agente pode continuar trabalhando nele. O zeltro ai abre uma sessão na pasta do projeto com o agente que você configurou (Claude, Codex, Antigravity, Qwen, Aider, OpenCode ou Hermes), e o Zeltro escreve um AGENTS.md descrevendo o endereço, o banco de dados e os comandos do projeto, para a sessão já começar sabendo onde está.

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 de demonstração e lista os arquivos que alterou
Uma sessão de agente na pasta do projeto, ao lado da lista de projetos, começando pelo AGENTS.md do projeto.

Esse é o verdadeiro motivo para trazer um app para casa: você para de pagar por prompt a uma plataforma e passa a usar uma assinatura ou um modelo local que você controla.

Bom saber#

Um app do Emergent só com front end roda com npm install && npm run devMesmo assim o Zeltro dá a ele um endereço fixo, um banco de dados compartilhado esperando para quando você precisar e o seu agente de IA trabalhando logo ao lado.

O Zeltro não hospedaO Emergent pode publicar para você; quando o app está no seu próprio computador, colocá-lo on-line fica por sua conta. Qualquer hospedagem serve, ou eu coloco no ar para você.

Quem define a exportação é o EmergentO que chega ao seu repositório depende dos planos deles, e isso pode mudar. É o melhor motivo para levar seu app para o seu próprio computador enquanto dá: quando ele roda no Zeltro, ele é seu.

Perguntas

O Emergent deixa eu exportar meu código?

Sim. O Emergent gera um código de verdade que você pode baixar, e do plano Standard para cima o repositório fica na sua própria conta do GitHub. Confira os detalhes do seu plano, porque as condições dos planos mudam.

Que banco de dados um app do Emergent usa?

Normalmente MongoDB, com FastAPI ou Node no backend. Por isso a configuração local dá mais trabalho do que nos criadores que só usam JavaScript: você precisa de uma instância do Mongo além de um runtime.

Posso continuar usando IA no app depois de trazê-lo para o meu computador?

Sim, e com o modelo que você escolher. O zeltro ai abre uma sessão de agente no projeto. Como o agente é seu, uma assinatura do Claude ou do ChatGPT que você já tem pode fazer o trabalho, ou um modelo mais barato do OpenRouter, ou o Ollama localmente.

Isso é diferente de exportar um projeto do Lovable ou do Bolt?

Sim, principalmente por causa do banco de dados e da segunda linguagem. As exportações do Lovable e do Bolt costumam ser Vite/React padrão e rodam de verdade com npm install && npm run dev. Uma exportação do Emergent traz junto um backend em Python e o MongoDB.

Preciso do Docker?

Sim. O Zeltro é baseado em Docker: nativo no Linux e no macOS, e no Windows pelo WSL2. Se você preferir não usar, o caminho manual acima funciona bem, só tem mais passos.

Experimente o Zeltro no seu próprio computador

Grátis para uso pessoal, sem conta. Crie com a IA que você já paga e fique com o app, os dados e o código no seu próprio computador.

Instalar o Zeltro Por que trazer sua própria chave

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

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