Objetivo técnico
Al terminar podrás ubicarte en un proyecto Node, instalar sus dependencias y ejecutar sus comandos sin copiar instrucciones a ciegas. Esto importa porque el RAG usa paquetes para el cliente de OpenAI, Supabase, validación y testing.
Antes de empezar
Necesitas una terminal y Node.js instalado. Compruébalo con node --version y npm --version. Si ambos comandos imprimen una versión, estás lista para continuar.
Paso a paso
- Ejecuta
pwdpara ver la carpeta actual ylspara listar su contenido. - Entra al proyecto con
cd nombre-del-proyecto. - Abre
package.json. La secciónscriptscontiene los comandos disponibles ydependenciesdeclara lo que el proyecto necesita. - Ejecuta
npm install. npm leepackage.json, descarga paquetes y creanode_modulesy, normalmente,package-lock.json. - Ejecuta los scripts uno por uno:
npm run dev
npm test
npm run build
dev levanta el entorno local, test verifica comportamiento y build confirma que el proyecto puede compilarse para producción. Los nombres exactos dependen de package.json.
Verificación
Ejecuta npm run para listar los scripts. Después ejecuta npm test. La verificación está completa cuando el comando termina con código 0 y no deja un proceso fallando.
Errores frecuentes
command not found: node: Node no está instalado o la terminal no recargó su ruta.Missing script: pediste un script que no existe; revisapackage.json.Cannot find module: faltan dependencias; vuelve a ejecutarnpm installdesde la carpeta correcta.
Práctica
Crea una carpeta temporal, ejecuta npm init -y y agrega el script "check": "node --version" en package.json. Ejecuta npm run check sin mirar los pasos anteriores. El feedback inmediato es la versión de Node y un código de salida exitoso.
Puente al RAG
En el Bloque 5 usarás esta secuencia para instalar SDKs, ejecutar migraciones y correr los tests del pipeline de retrieval. Si no puedes explicar qué hace un script de npm, repite la práctica antes de empezar.