Zeltro › Cómo ejecutar un proyecto de Replit en local
Ejecutar un proyecto de Replit en tu propio equipo
Cómo exportar un proyecto de Replit como zip o a GitHub, ejecutarlo en tu propio equipo, mover su base de datos Postgres y sus secretos, y seguir desarrollándolo con tu propia IA. Pasos reales, para proyectos de Python y de Node por igual.
Replit es un equipo entero en una pestaña del navegador, y eso es a la vez su punto fuerte y la razón por la que sacar un proyecto de ahí requiere pensarlo un poco. Un proyecto de Replit puede ser un script de Python, una app de Flask o FastAPI, o una app de Node y React con una base de datos Postgres detrás. El código se exporta con facilidad. Lo que rodea al código (la base de datos, los secretos, la configuración de ejecución) no.
Esta página lo cubre todo: sacar el código, ejecutarlo en tu propio equipo, mover los datos y seguir desarrollándolo con el agente de IA que elijas.
Qué viene con una exportación y qué no#
La propia página de ayuda de Replit lo deja claro: los secretos, la base de datos y la configuración de despliegue «no se incluyen en la copia».
| Pieza | ¿Sale con el código? | Qué hacer |
|---|---|---|
| Tu código | Sí, en zip o por GitHub | Clónalo o descomprímelo |
.replit y replit.nix |
Sí, como archivos | Léelos para ver el comando de ejecución y los paquetes del sistema |
| Secretos | No | Vuelve a crearlos en un .env local |
| Base de datos PostgreSQL | No | Haz un volcado y cárgalo en local |
| Servicios de Replit (Auth, Object Storage, la base de datos clave-valor) | No | Sustitúyelos por los tuyos |
Paso 1: exporta el código de Replit#
Descarga un zip. Abre el menú de tres puntos en la parte superior del árbol de archivos y elige Download as zip. Si un proyecto grande no se descarga, la documentación de Replit sugiere abrir el Shell y ejecutar:
zip -r project.zip .
y luego descargar project.zip desde el árbol de archivos.
O expórtalo a GitHub, que es mejor si vas a seguir trabajando en él. Vincula GitHub desde los servicios conectados de tu cuenta, abre la herramienta Git del proyecto y conecta o crea un repositorio. Activa la sincronización automática en el panel de Git y se sincroniza en ambos sentidos, así que puedes trabajar en local y seguir abriendo el proyecto en Replit.
Antes de irte, abre la herramienta Secrets y copia los nombres de todo lo que haya. Vas a necesitar los valores otra vez.
Paso 2: ejecuta el proyecto de Replit en local#
Mira primero .replit. Su línea run es el comando que Replit usaba para arrancar la
app, y replit.nix enumera los paquetes del sistema que incorporó.
Puedes ejecutarlo a mano: instala la versión correcta de Python o Node, crea un
virtualenv o ejecuta npm install, define los secretos como variables de entorno,
arranca Postgres si la app lo necesita y ejecuta el comando de .replit. Para un solo
proyecto, está bien.
Zeltro ya tiene todas las piezas montadas: imágenes base de Python 3.12 y Node 22 con todos los drivers de bases de datos compilados, y un Postgres, MariaDB, MongoDB y Redis compartidos por todos los proyectos del equipo.
zeltro clone work-directly https://github.com/you/your-replit-app --database postgres
Zeltro lee los archivos del proyecto (main.py, app.py, manage.py, package.json)
para deducir el framework, crea el proyecto, le da su propia base de datos en el
Postgres compartido, escribe los datos de conexión en .env y le asigna una dirección.
Si tienes un agente de IA configurado, al clonar también le pide que adapte el
repositorio a Zeltro. zeltro status your-replit-app muestra la dirección.
Si partes de un zip, descomprímelo en tu carpeta de proyectos (~/zeltro-projects por
defecto) y ejecuta zeltro setup your-replit-app postgres.
Las apps de Replit suelen escuchar en el puerto que Replit les haya dado, a menudo en
0.0.0.0. Dentro de Zeltro, una app de Python escucha en el puerto 8000 y una de Node
en el 3000, y nginx las sirve en el puerto 80. Si la página no carga, el puerto es lo
primero que hay que revisar, y tu agente puede cambiarlo.
Paso 3: mueve la base de datos y los secretos#
El PostgreSQL de Replit está construido sobre Neon, y la app lo encuentra mediante
DATABASE_URL. Para llevarte los datos, haz un volcado desde el Shell de Replit:
pg_dump "$DATABASE_URL" --no-owner --no-acl -f dump.sql
Descarga dump.sql y cárgalo en la base de datos del proyecto en el Postgres compartido
de Zeltro (host zeltro-postgres, usuario root), o pídeselo a tu agente. Algunos
usuarios de Replit cuentan que pg_dump se niega a ejecutarse porque el cliente del
espacio de trabajo es más antiguo que el servidor; si te pasa, ejecuta el mismo comando
desde tu propio equipo con un pg_dump más reciente y la misma cadena de conexión.
En cuanto a los secretos, añade cada uno al .env del proyecto. Los que apuntaban al
propio Replit, como Replit Auth, Object Storage o la base de datos clave-valor, necesitan
un sustituto: tu propio inicio de sesión, una carpeta local o un almacenamiento
compatible con S3, y Redis o una tabla en Postgres.
Paso 4: sigue desarrollando, con tu propia IA#
En Replit, el trabajo del Agent lo cobra Replit. Cuando el proyecto ya funciona en local, el agente puede ser el tuyo: Claude Code, Codex, Antigravity, Qwen Code, Aider, OpenCode o Hermes, con una suscripción que ya pagas, una clave de API al precio del proveedor o un modelo local gratuito.
cd ~/zeltro-projects/your-replit-app
zeltro ai "read AGENTS.md, then replace Replit Auth with email and password sign-in"
Cada proyecto tiene un AGENTS.md que describe su dirección, su base de datos y sus
comandos, así que el agente empieza ya orientado. Consulta
trae tu propia clave para ver cómo funciona, o prueba tus
propias cifras en la calculadora de ahorro.
Como Zeltro ejecuta PHP, Python y Node uno junto al otro, el próximo proyecto no tiene por qué usar el mismo stack. Un panel de administración en Laravel, un servicio en FastAPI y un frontend en Next.js pueden estar en carpetas vecinas y comunicarse entre sí por su nombre.
Conviene saber#
Zeltro no alojaReplit puede desplegar por ti; una vez que el proyecto está en tu equipo, publicarlo en internet depende de ti. Sirve cualquier hosting, o lo publico yo por ti.
Necesitas DockerZeltro lo instala por ti en Linux y macOS. En Windows se ejecuta en WSL2, que Zeltro configura por su cuenta: el instalador pide permiso de administrador una vez, y puede que el equipo necesite reiniciarse una vez.
Fuentes#
Revisadas el 18 de octubre de 2026: las páginas de Replit sobre proyectos y archivos, la interfaz de Git y PostgreSQL, y un informe del foro de Replit sobre incompatibilidades de versión de pg_dump. Las funciones cambian, así que compruébalas en tu propia cuenta.
Preguntas
¿Puedo ejecutar un proyecto de Replit en local?
Sí. Descárgalo como zip o sincronízalo con GitHub, y ejecútalo con el mismo comando que
la línea run de .replit. Los secretos, la base de datos y la configuración de
despliegue no vienen con él, así que tendrás que recrearlos en tu equipo.
¿Cómo exporto el código de Replit?
Usa Download as zip en el menú de tres puntos de la parte superior del árbol de
archivos, o conecta GitHub en la herramienta Git y sube el código a un repositorio. Si la
descarga del zip falla, ejecuta zip -r project.zip . en el Shell y descarga ese archivo.
¿Cómo exporto una base de datos de Replit?
El PostgreSQL de Replit funciona sobre Neon y se accede a él mediante DATABASE_URL.
Ejecuta pg_dump "$DATABASE_URL" desde el Shell, o desde tu propio equipo, y carga el
volcado en un Postgres local.
¿Cómo exporto un proyecto de Replit a GitHub?
Vincula GitHub desde los servicios conectados de tu cuenta y luego conecta un repositorio en la herramienta Git del proyecto. Activa la sincronización automática para que se sincronice en ambos sentidos.
¿Mis secretos de Replit vienen con la exportación?
No. Replit deja los secretos fuera de las copias a propósito. Anota los nombres antes de
irte y añade los valores a un .env local.
¿Hay alguna alternativa a Replit que funcione en local?
Para crear con IA en tu propio equipo, Zeltro es una: funciona en local, usa tu propio agente de IA y crea apps en PHP y Python además de JavaScript. Su herramienta de línea de comandos es de código abierto. Consulta la comparación completa de creadores de apps con IA.
¿Cuánto cuesta Zeltro?
La app Zeltro es gratis para uso personal, proyectos de afición y aprendizaje, y sin
cuenta. Una empresa que la use, también para trabajos pagados para clientes, compra una
licencia comercial de por vida una sola vez, por US$99.99. La
herramienta de línea de comandos zeltro es de código abierto (MIT). Aparte, pagas tu
IA: una suscripción que ya tienes, una clave de API que se cobra por uso, o nada con un
modelo local.
Tráete tu proyecto de Replit a casa
Instala Zeltro, clona tu proyecto de Replit y sigue desarrollándolo con la IA que ya pagas, o con un modelo local gratuito. Python y Node funcionan sin configurar nada. Gratis para uso personal y sin cuenta.
Instalar Zeltro Por qué traer tu propia clave
¿Prefieres no configurarlo tú? Lo hago yo por ti.
Revisado el 2026-11-09. Los otros productos cambian a menudo: si algo aquí está desactualizado, avísanos y lo corregimos.