Ejecutar el código localmente

Todo en este curso se ejecuta en el navegador en Scrimba, y nunca tienes que irte. Pero en algún momento es posible que quieras el proyecto en tu máquina: para seguir construyendo sobre él después del curso, para usar tu editor preferido, o para ponerlo en tu propio repositorio de Git.

Esta página cubre eso. Es opcional, y nada más adelante en el curso depende de esto.

Lo que necesitas primero

Una versión LTS compatible de Node.js. Se recomienda Node 24, y Node 22 también funciona. Verifica qué tienes:

$ node --version
v24.18.0

Si dice "command not found", instala la versión marcada como LTS desde nodejs.org.

npm. Node incluye npm, y las descargas de Scrimba son proyectos de npm. Verifica que esté disponible:

$ npm --version
11.18.0

JunoLo que necesitas primero Usa una versión LTS compatible de Node.js: Node 24 es recomendado y Node 22 funciona. El curso tiene un piso mínimo en Node 20.12 porque es donde Node añadió la API integrada para archivos de entorno, pero cumplir un piso de compatibilidad no es lo mismo que ejecutar una versión mantenida.

Obtén el código

Haz clic derecho en el título del proyecto en el editor de Scrimba y elige Download as Zip. Descomprime el archivo descargado, luego muévete a su carpeta en tu terminal:

$ cd intro-to-ai-agents-lesson

Echa un vistazo a lo que hay. Deberías ver server.js, package.json, package-lock.json, environment.js, vite.config.js, y los archivos JavaScript propios de la lección.

JunoObtén el código Descarga el proyecto como Zip, descomprímelo, y usa cd para moverte a la carpeta que contiene package.json. Esa carpeta es donde cada comando en esta página se ejecuta.

Instala y ejecuta

Esta es la única diferencia real entre Scrimba y tu máquina, y es el paso que la gente se salta.

En Scrimba, AI_URL, AI_KEY y AI_MODEL se guardan en la configuración de tu cuenta, y Scrimba los inyecta en el proyecto en ejecución. Por eso no hay un archivo .env en la versión del navegador: no se necesita allí, y además sería un lugar pobre para guardar una clave en un editor compartido.

Nada las inyecta en tu máquina, así que tú las proporcionas. Abre la configuración de tu cuenta en Scrimba, copia los mismos tres valores, y guárdalos en un archivo llamado .env en la carpeta del proyecto, junto a package.json:

AI_URL=<pega de la configuración de Scrimba>
AI_KEY=<pega de la configuración de Scrimba>
AI_MODEL=<pega de la configuración de Scrimba>

Un nombre por línea, sin comillas ni espacios alrededor del =. environment.js lee ese archivo cuando el proyecto arranca, usando la compatibilidad de archivos de entorno integrada en Node. Esa es la razón completa del piso mínimo de versión más arriba en la página.

Si pones este proyecto en un repositorio de Git propio, mantén .env fuera. AI_KEY es una credencial, y una clave que llega a un repositorio público es una clave que tienes que reemplazar. Un .gitignore de una línea en la carpeta del proyecto lo cubre:

.env

El manual de Git profundiza en el hábito más amplio en ignorando archivos y buenas prácticas.

Con esto en su lugar, instala las dependencias:

$ npm install

npm lee la lista de dependencias de package.json y las versiones exactas resueltas de package-lock.json, para que obtengas el mismo árbol del que se grabó la lección. Escribe una carpeta node_modules, que es grande y reconstruible, así que eso también pertenece a .gitignore.

Luego inicia el proyecto:

$ npm run dev

  ➜  Local:   http://localhost:5173/

Abre la dirección que imprime. En una configuración de Vite predeterminada eso es http://localhost:5173/, y leer la línea es mejor que asumir, por la razón que cubre la siguiente sección.

JunoInstala y ejecuta Copia AI_URL, AI_KEY y AI_MODEL de tu configuración de Scrimba a un archivo .env junto a package.json, porque nada los inyecta para ti fuera de la plataforma. Luego npm install y npm run dev. Añade .env a .gitignore antes de hacer commit de nada: una clave que llega a un repositorio público es una clave que tienes que reemplazar.

Cuando el puerto ya está en uso

Un servidor de desarrollo necesita un puerto libre, y 5173 es el predeterminado de Vite, así que cualquier otra cosa ejecutando Vite probablemente ya lo haya reclamado. Esto no rompe tu proyecto. Vite toma el siguiente puerto, lo dice, y continúa:

$ npm run dev
Port 5173 is in use, trying another one...

  ➜  Local:   http://localhost:5174/

Si 5174 también está ocupado lo intenta con 5175, luego 5176, contando hacia arriba hasta encontrar uno que esté libre. Así que el puerto no importa y nunca tienes que elegir uno. Lee la URL de la línea que Vite imprime y abre esa. Construir el hábito de leer esa línea, en lugar de escribir localhost:5173 de memoria, es lo que previene una búsqueda de "la página no carga" más adelante.

Cuando sí quieras un puerto en particular, pásalo:

$ npm run dev -- --port 4000

El -- desnudo es lo que entrega el resto de la línea a Vite en lugar de que npm se quede con la bandera para sí mismo.

Un caso se comporta diferente. Si un proyecto configura strictPort en vite.config.js, Vite se detiene en lugar de contar hacia arriba, e imprime Port 5173 is already in use. Entonces o bien cierras lo que está ocupando el puerto o pasas --port como arriba.

JunoCuando el puerto ya está en uso Vite no necesita un puerto en particular. Si 5173 está ocupado cuenta hacia arriba a 5174, luego 5175, imprime el que consiguió, y se ejecuta igual de cualquier forma. Lee esa URL impresa en lugar de escribir localhost:5173 de memoria, y recurre a npm run dev -- --port 4000 en la rara ocasión de que necesites uno específico.

A dónde ir desde aquí

Lo que tienes ahora es un proyecto normal de npm, así que cualquier cosa que aprendas sobre herramientas de Node se aplica directamente. Si quieres ponerlo en control de versión, tu primer repositorio te guía a través del primer commit, y el .gitignore de arriba es lo que tienes que configurar antes de hacerlo.

Nada más adelante en el curso depende de nada de esto. Si la copia local te da problemas, la versión de Scrimba sigue ahí y sigue funcionando.