Introducción
En esta lección abordaremos los problemas más comunes relacionados con la instalación local de Node.js y/o FlowWise.
En el próximo video procederemos con la instalación de FlowWise en Node.js. Si no tienes ningún problema con la instalación normal de Node.js, puedes omitir esta lección ya que nos enfocaremos únicamente en NVM para Windows y cómo gestionar las versiones de Node.
Aunque el proceso es bastante sencillo, considero que esta información puede ser valiosa incluso si no experimentas problemas con la instalación de FlowWise. Si prefieres, puedes pasar directamente al siguiente video para instalar FlowWise inmediatamente y regresar a esta lección solo si la instalación local no funciona correctamente.
El Problema Principal: Versiones Incompatibles de Node
Uno de los problemas más frecuentes que observo constantemente es el uso de una versión incorrecta de Node. FlowWise, al menos en este momento, solo funciona con las versiones 18, 19 o 20 de Node.js.
Si instalas la versión más reciente de Node, es muy probable que estés trabajando con la versión 22 o incluso la 23. Para solucionar esto, necesitamos hacer un downgrade (bajar la versión) de Node.js.
Requisitos Previos
Antes de comenzar, asegúrate de que:
- Eres administrador de tu sistema (esto es fundamental)
- Tienes Node.js ya instalado (lo más probable)
Verificando tu Versión Actual de Node
Para verificar qué versión de Node tienes activada actualmente, abre tu terminal y ejecuta:
node --version
Por ejemplo, en mi sistema actualmente tengo la versión 20.16.0 activa. Ejecuta este comando para ver qué versión tienes instalada.
Instalando NVM para Windows
Paso 1: Descargar NVM
- Busca en Google «NVM for Windows»
- Haz clic en el primer enlace disponible en GitHub
- Desplázate hacia abajo y presiona «Download Now»
- Descarga el archivo «NVM setup.exe»
Paso 2: Instalar NVM
- Ejecuta el archivo descargado
- Sigue el proceso de instalación normal
- Una vez completada la instalación, abre tu terminal nuevamente
Usando NVM: Comandos Básicos
Listar Versiones Instaladas
nvm list
Este comando mostrará todas las versiones de Node instaladas en tu sistema.
Verificar Versiones Disponibles
Puedes visitar el sitio web oficial de Node.js para ver todas las versiones disponibles, desde la más reciente (como 23.6) hasta versiones anteriores.
Instalar una Nueva Versión
Para instalar una versión específica, usa:
nvm install [número_de_versión]
Ejemplo práctico:
nvm install 18.20.5
La instalación será prácticamente instantánea.
Cambiar Entre Versiones
Para cambiar de una versión a otra:
nvm use [número_de_versión]
Ejemplo: Para cambiar de la versión 20.16.0 a la 18.20.5:
nvm use 18.20.5
Verificar la Versión Activa
Después de cambiar de versión, puedes verificar cuál está activa usando:
nvm list
La versión activa aparecerá marcada con un asterisco (*).
Recomendación para FlowWise
Recomiendo encarecidamente usar la versión 20.18.0 para FlowWise, ya que es la que utilizo personalmente y nunca presenta problemas en mi sistema.
Para instalar y activar esta versión:
nvm install 20.18.0
nvm use 20.18.0
Luego verifica que esté activa:
nvm list
Resumen
En pocas palabras: Si experimentas problemas con la instalación de FlowWise en Node.js, muy probablemente se deba a que estás usando una versión demasiado nueva o demasiado antigua.
Solución simple: Cambia a la versión 20.18.0 y todo debería funcionar correctamente.
Puntos Clave a Recordar
Siempre verifica que tengas permisos de administrador antes de realizar cambios
FlowWise solo es compatible con Node.js versiones 18, 19 o 20
Las versiones 22 y 23 pueden causar problemas de compatibilidad
NVM facilita enormemente la gestión de múltiples versiones de Node
La versión 20.18.0 es altamente recomendada para FlowWise