Zeltro › Cómo ejecutar un proyecto de Bolt.new en local

Ejecutar un proyecto de Bolt.new en tu propio equipo

¿Se puede ejecutar Bolt.new en local? El creador no, tu proyecto sí. Cómo descargar un proyecto de Bolt o traerlo desde GitHub, ejecutarlo en tu propio equipo, resolver la base de datos de Bolt y seguir editándolo con tu propia IA.

«Ejecutar Bolt.new en local» puede significar dos cosas, y las respuestas son distintas.

Bolt.new en sí, el creador, no se instala. Funciona en tu navegador, en los servidores de Bolt, con la IA y los tokens de Bolt. Su hermano de código abierto, bolt.diy, puede ejecutarse en tu propio equipo con tus propias claves de API, pero es un proyecto aparte, sin cuentas compartidas, y su última versión salió en mayo de 2025.

Tu proyecto de Bolt sí se ejecuta en local. La propia documentación de Bolt te explica cómo: descárgalo, instala Node.js, npm install && npm run dev. Esta página trata de eso, y de lo que viene después: mantener el proyecto funcionando y seguir avanzando una vez que dejas de construirlo dentro de Bolt.

Bolt.newDonde se construyó la app
Zip o GitHubExport → Download, o sincronización
Tu equipoZeltro lo ejecuta, con una base de datos local
Tu IASigue construyendo, sin créditos

Qué es un proyecto de Bolt#

Bolt construye apps de JavaScript, casi siempre React sobre Vite, y sus backends son solo de JavaScript. Aquí eso es una buena noticia: un proyecto de JavaScript es el más fácil de ejecutar en cualquier sitio.

Pieza Dónde vive ¿Viene con la descarga?
Tu código En Bolt, y en GitHub si lo conectaste Sí
Base de datos En Bolt Cloud (construido sobre Supabase), si el proyecto tiene una No
Secretos y variables de entorno En Bolt No cuentes con ello; revisa tu .env
Hosting Bolt Cloud No

Paso 1: saca el código de Bolt#

Hay dos formas, y la segunda es mejor si piensas seguir adelante.

Descarga un zip. Abre el proyecto, haz clic en su título arriba a la izquierda, después en Export → Download, y descomprímelo. En palabras de Bolt: «Puedes descargar tu proyecto como archivo zip para trabajar en él fuera de Bolt, con tu propio editor de código».

Conecta GitHub. Haz clic en el icono de GitHub en Bolt, inicia sesión, instala la GitHub App de Bolt y crea un repositorio para el proyecto. Empieza como un repositorio privado en main. A partir de ahí Bolt hace los commits por ti: «Cada vez que haces un cambio que no rompe el proyecto, Bolt crea un commit por ti». Además, «revisa GitHub cada 30 segundos en busca de cambios hechos fuera de Bolt y los incorpora», así que el trabajo en local y Bolt pueden convivir. Haz tu trabajo local en una rama: si los dos lados cambian en el mismo momento, «Bolt conserva tus cambios y sobrescribe la versión de GitHub».

Paso 2: ejecútalo, la forma rápida#

Para un primer vistazo, esto es todo lo que necesitas:

  1. Instala Node.js.
  2. Abre una terminal en la carpeta del proyecto.
  3. Ejecuta npm install && npm run dev.

El frontend arranca en el puerto que indique su servidor de desarrollo. Si la app tiene una base de datos de Bolt, sigue apuntando a Bolt Cloud, o no está conectada a nada.

Paso 2, la forma que puedes seguir usando#

La forma rápida está bien una vez. Se vuelve tediosa cuando tienes tres proyectos así, cada uno en su puerto, cada uno con su versión de Node, y ninguno con base de datos propia.

Zeltro es una plataforma de desarrollo local gratuita pensada justo para eso. Cada proyecto se ejecuta en su propio contenedor, todos los proyectos comparten un mismo MariaDB, Postgres, MongoDB y Redis, y tu agente de IA trabaja dentro del proyecto. Para traer un proyecto de Bolt desde GitHub:

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

Desde un zip, descomprímelo en tu carpeta de proyectos (~/zeltro-projects por defecto) y adóptalo:

zeltro setup your-bolt-app

En ambos casos, Zeltro lee package.json, deduce el framework (React, Vue, Next.js, Nuxt, SvelteKit, Astro, Express y más) y configura el proyecto con Node 22. Si tienes un agente de IA configurado, clone además le pide que adapte el repositorio a Zeltro. Después:

zeltro status your-bolt-app

muestra su dirección en este equipo y una dirección de red local para tu teléfono. Nada que recordar, ningún puerto que elegir, y el próximo proyecto de Bolt que traigas tendrá la suya.

Dentro de Zeltro, el servidor de desarrollo de una app de Node escucha en el puerto 3000 y el navegador llega a él a través de nginx en el puerto 80. Un proyecto de Vite que usa 5173 por defecto necesita --port 3000 en su script de desarrollo y, para la recarga en caliente, server.ws.clientPort: 80 (server.hmr.clientPort antes de Vite 8.1) en vite.config. Si la página o la recarga en caliente no aparecen, casi siempre es por eso, y tu agente puede arreglarlo.

La app Zeltro: una barra lateral de proyectos, cada uno con su indicador de ejecución, sus direcciones local y de red local, y botones para iniciarlo, detenerlo, editarlo y abrirlo
Cada proyecto de Bolt que traes tiene su propia dirección, sin nada que recordar.

Paso 3: la base de datos de Bolt#

Si el proyecto usa una base de datos de Bolt, decide dónde deben vivir sus datos:

Opción 1

Déjala en Bolt Cloud

Por ahora, mientras trabajas en el frontend. Recuerda que entonces los cambios en local tocan datos reales.

Opción 2

Reclámala en Supabase

Bolt puede pasar la base de datos a tu propia cuenta de Supabase desde la pestaña Advanced del icono de base de datos. La documentación de Bolt dice que «reclamarla requiere un plan Pro o Teams». Después apunta el .env de la app a tu proyecto.

Opción 3

Pásala a una base de datos local

Zeltro ya ejecuta Postgres, MariaDB y MongoDB para cada proyecto. Saca los datos y pide a tu agente de IA que los cargue y reescriba la capa de datos para usarla, paso a paso, contra una base de datos en tu propio equipo.

No conectes una base de datos nueva de Supabase encima de una base de datos de Bolt existente para «moverla»: Bolt advierte que reemplazar la conexión «puede causar pérdida de datos».

Configuración de Zeltro, pestaña Servicios: zeltro-mariadb, zeltro-redis, zeltro-memcached y phpMyAdmin en ejecución, cada uno con su dirección
Los servicios compartidos que usa cada proyecto. Postgres y MongoDB se suman cuando un proyecto los necesita.

Paso 4: sigue editando, sin tokens de Bolt#

Una vez que el proyecto funciona en local, la IA que lo edita puede ser la tuya. Zeltro no tiene IA propia ni tokens que comprar. Ejecuta el agente que elijas (Claude Code, Codex, Antigravity, Qwen Code, Aider, OpenCode o Hermes) con una suscripción que ya tienes, una clave de API al precio del propio proveedor, o un modelo local gratuito.

cd ~/zeltro-projects/your-bolt-app
zeltro ai "read AGENTS.md, then add a contact form that saves to the database"

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, o prueba con tus propias cifras en la calculadora de ahorro.

Además, ya no estás limitado a JavaScript. Si la app necesita un backend en Laravel, Django o FastAPI, constrúyelo en la carpeta de al lado, y los dos proyectos se encuentran por nombre en la red de Zeltro.

La app Zeltro con una sesión de Claude Code junto a la lista de proyectos, que acaba de añadir un cuadro de búsqueda a una app de recetas y enumera los archivos que cambió
Tu propio agente trabajando, con tu propio plan, junto a tus proyectos.

Fuentes#

Revisadas el 18 de octubre de 2026: las páginas de Bolt sobre proyectos y archivos, Git, base de datos: opciones avanzadas y tecnologías compatibles. Los planes y las funciones cambian, así que compruébalos en tu propia cuenta.

Preguntas

¿Puedo ejecutar Bolt.new en local?

El creador, no: bolt.new funciona en el navegador, en los servidores de Bolt. Su hermano de código abierto bolt.diy puede ejecutarse en local, pero es un proyecto aparte y que avanza más despacio. Tu proyecto de Bolt, sí: descárgalo o sincronízalo con GitHub y ejecútalo con Node.js.

¿Cómo ejecuto un proyecto de Bolt.new en local?

Descárgalo con Export → Download (o clónalo desde GitHub), instala Node.js y ejecuta npm install && npm run dev en la carpeta del proyecto. Eso levanta el frontend. Una base de datos de Bolt Cloud se queda en Bolt Cloud hasta que la reclames o la muevas.

¿Puedo instalar Bolt.new en mi equipo?

No existe una versión instalable de bolt.new. Si quieres un creador con IA que funcione en tu propio equipo, Zeltro es uno: se ejecuta en local, usa tu propio agente de IA y crea apps en PHP y Python además de JavaScript. Consulta la comparativa completa con Bolt.new.

¿La descarga de Bolt incluye la base de datos?

No. El zip es tu código. La documentación de Bolt no dice que incluya tu base de datos ni tus secretos, así que planifícalos por separado: reclama la base de datos en Supabase (plan Pro o Teams) o mueve los datos a una base de datos que gestiones tú.

¿Puedo seguir usando Bolt después de pasar el proyecto a local?

Sí, si usas la sincronización con GitHub. Bolt hace commit de sus cambios en el repositorio e incorpora los tuyos cada 30 segundos. Trabaja en una rama en local y fusiona en GitHub, porque Bolt no fusiona ramas dentro de la app.

¿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.

Sigue construyendo tu app de Bolt en local

Instala Zeltro, trae tu proyecto de Bolt desde GitHub o desde un zip, y sigue editándolo con la IA que ya pagas o con un modelo local gratuito. 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-10-18. Los otros productos cambian a menudo: si algo aquí está desactualizado, avísanos y lo corregimos.