Zeltro › Como rodar um projeto do Replit localmente
Rodando um projeto do Replit no seu próprio computador
Como exportar um projeto do Replit em zip ou para o GitHub, rodá-lo no seu próprio computador, levar o banco de dados Postgres e os segredos dele, e continuar desenvolvendo com a sua própria IA. Passos reais, para projetos em Python e em Node.
O Replit é um computador inteiro em uma aba do navegador, e isso é ao mesmo tempo a força dele e o motivo pelo qual tirar um projeto de lá pede um pouco de cuidado. Um projeto do Replit pode ser um script em Python, um app em Flask ou FastAPI, ou um app em Node e React com um banco de dados Postgres por trás. O código sai fácil. O que está em volta do código (o banco de dados, os segredos, a configuração de execução) não.
Esta página cobre tudo isso: tirar o código, rodá-lo no seu próprio computador, levar os dados e continuar desenvolvendo com um agente de IA que você escolhe.
O que vem com uma exportação, e o que não vem#
A própria página de ajuda do Replit é clara: os segredos, o banco de dados e a configuração de implantação "não estão incluídos na cópia".
| Parte | Sai junto com o código? | O que fazer |
|---|---|---|
| Seu código | Sim, em zip ou pelo GitHub | Clone ou descompacte |
.replit e replit.nix |
Sim, como arquivos | Leia para achar o comando de execução e os pacotes do sistema |
| Segredos | Não | Recrie em um .env local |
| Banco de dados PostgreSQL | Não | Faça um dump e carregue localmente |
| Serviços do Replit (Auth, Object Storage, banco de dados chave-valor) | Não | Substitua pelos seus |
Passo 1: exporte o código do Replit#
Baixe um zip. Abra o menu de três pontos no topo da árvore de arquivos e escolha Download as zip. Se um projeto grande não baixar, a documentação do Replit sugere abrir o Shell e rodar:
zip -r project.zip .
e depois baixar o project.zip pela árvore de arquivos.
Ou exporte para o GitHub, o que é melhor se você vai continuar. Conecte o GitHub nos serviços conectados da sua conta, abra a ferramenta Git no projeto e conecte ou crie um repositório. Ative a sincronização automática no painel do Git e ela funciona nos dois sentidos, então você pode trabalhar localmente e ainda abrir o projeto no Replit.
Antes de sair, abra a ferramenta Secrets e copie os nomes de tudo o que está lá. Você vai precisar dos valores de novo.
Passo 2: rode o projeto do Replit localmente#
Olhe o .replit primeiro. A linha run é o comando que o Replit usava para iniciar o
app, e o replit.nix lista os pacotes do sistema que ele puxava.
Dá para rodar na mão: instale a versão certa do Python ou do Node, crie um virtualenv ou
rode npm install, defina os segredos como variáveis de ambiente, inicie um Postgres se o
app precisar e rode o comando do .replit. Para um projeto só, tudo bem.
O Zeltro já tem as peças de pé: imagens base de Python 3.12 e Node 22 com todos os drivers de banco de dados compilados, e um Postgres, um MariaDB, um MongoDB e um Redis compartilhados por todos os projetos da máquina.
zeltro clone work-directly https://github.com/you/your-replit-app --database postgres
O Zeltro lê os arquivos do projeto (main.py, app.py, manage.py, package.json) para
descobrir o framework, cria o projeto, dá a ele um banco de dados próprio no Postgres
compartilhado, grava as configurações de conexão no .env e atribui um endereço. Com um
agente de IA configurado, o clone também faz o agente adaptar o repositório ao Zeltro.
zeltro status your-replit-app mostra o endereço.
Se você tem um zip, descompacte na sua pasta de projetos (~/zeltro-projects por padrão)
e rode zeltro setup your-replit-app postgres.
Apps do Replit costumam escutar na porta que o Replit deu a eles, muitas vezes em
0.0.0.0. Dentro do Zeltro, um app Python escuta na porta 8000 e um app Node na porta
3000, e o nginx serve os dois na porta 80. Se a página não abrir, a porta é a primeira
coisa a verificar, e o seu agente pode mudá-la.
Passo 3: leve o banco de dados e os segredos#
O PostgreSQL do Replit roda sobre o Neon, e o app o encontra pela DATABASE_URL. Para
levar os dados com você, faça um dump pelo Shell do Replit:
pg_dump "$DATABASE_URL" --no-owner --no-acl -f dump.sql
Baixe o dump.sql e carregue no banco de dados do projeto no Postgres compartilhado do
Zeltro (host zeltro-postgres, usuário root), ou peça ao seu agente que faça isso.
Usuários do Replit relataram o pg_dump se recusando a rodar porque o cliente do
workspace é mais antigo que o servidor; se isso acontecer, rode o mesmo comando no seu
próprio computador, com um pg_dump mais novo, contra a mesma string de conexão.
Para os segredos, adicione cada um ao .env do projeto. Os que apontavam para o próprio
Replit, como o Replit Auth, o Object Storage ou o banco de dados chave-valor, precisam de
um substituto: seu próprio login, uma pasta local ou um armazenamento compatível com S3, e
o Redis ou uma tabela no Postgres.
Passo 4: continue desenvolvendo, com a sua própria IA#
No Replit, o trabalho do Agent é cobrado pelo Replit. Quando o projeto roda localmente, o agente pode ser o seu: Claude Code, Codex, Antigravity, Qwen Code, Aider, OpenCode ou Hermes, com uma assinatura que você já paga, uma chave de API ao preço do fornecedor ou um modelo local gratuito.
cd ~/zeltro-projects/your-replit-app
zeltro ai "read AGENTS.md, then replace Replit Auth with email and password sign-in"
Todo projeto tem um AGENTS.md que descreve o endereço, o banco de dados e os comandos
dele, então o agente já começa sabendo onde está. Veja traga sua própria chave
para entender como isso funciona, ou teste os seus números na
calculadora de economia.
Como o Zeltro roda PHP, Python e Node lado a lado, o próximo projeto não precisa usar a mesma stack. Um painel administrativo em Laravel, um serviço em FastAPI e um front end em Next.js podem ficar em pastas vizinhas e se encontrar pelo nome.
Bom saber#
O Zeltro não hospedaO Replit pode publicar para você; quando o projeto está no seu computador, colocá-lo on-line fica por sua conta. Qualquer hospedagem serve, ou eu coloco no ar para você.
Você precisa do DockerO Zeltro instala para você no Linux e no macOS. No Windows, ele roda no WSL2, que o próprio Zeltro configura: o instalador pede permissão de administrador uma vez, e o computador pode precisar reiniciar uma vez.
Fontes#
Verificadas em 18 de outubro de 2026, nas páginas do Replit sobre projetos e arquivos, a interface do Git e PostgreSQL, e em um relato no fórum do Replit sobre incompatibilidade de versões do pg_dump. Os recursos mudam, então confira na sua própria conta.
Perguntas
Posso rodar um projeto do Replit localmente?
Sim. Baixe em zip ou sincronize com o GitHub, e depois rode com o mesmo comando da linha
run do .replit. Os segredos, o banco de dados e as configurações de implantação não
vêm junto, então recrie isso no seu computador.
Como exporto o código do Replit?
Use Download as zip no menu de três pontos no topo da árvore de arquivos, ou conecte o
GitHub na ferramenta Git e envie para um repositório. Se o download do zip falhar, rode
zip -r project.zip . no Shell e baixe esse arquivo.
Como exporto um banco de dados do Replit?
O PostgreSQL do Replit roda no Neon e pode ser acessado pela DATABASE_URL. Rode
pg_dump "$DATABASE_URL" pelo Shell, ou do seu próprio computador, e carregue o dump em
um Postgres local.
Como exporto um projeto do Replit para o GitHub?
Conecte o GitHub nos serviços conectados da sua conta e depois conecte um repositório na ferramenta Git do projeto. Ative a sincronização automática para sincronizar nos dois sentidos.
Meus segredos do Replit vêm com a exportação?
Não. O Replit deixa os segredos de fora das cópias de propósito. Anote os nomes antes de
sair e adicione os valores a um .env local.
Existe uma alternativa local ao Replit?
Para criar com IA no seu próprio computador, o Zeltro é uma: roda localmente, usa o seu próprio agente de IA e cria apps em PHP e Python, além de JavaScript. A ferramenta de linha de comando dele é de código aberto. Veja a comparação completa dos criadores de apps com IA.
Quanto custa o Zeltro?
O app Zeltro é grátis para uso pessoal, projetos de hobby e aprendizado, sem conta. Uma
empresa que usa o Zeltro, inclusive para 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 a
sua IA: uma assinatura que você já tem, uma chave de API cobrada por uso, ou nada com um
modelo local.
Traga seu projeto do Replit para casa
Instale o Zeltro, clone seu projeto do Replit e continue desenvolvendo com a IA que você já paga, ou com um modelo local gratuito. Python e Node rodam de cara. 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-11-09. Os outros produtos mudam com frequência: se algo aqui estiver desatualizado, avise a gente e a gente corrige.