1.2- Instala Flowise en tu propio ordenador

En esta lección vamos a instalar Flowise en tu ordenador. Sigue estos pasos con atención y lo tendrás funcionando en pocos minutos.

¿Qué necesitamos antes de empezar?

Antes de instalar Flowise, necesitamos tener instalado Node.js en nuestro sistema. Node.js es como el motor que permite que Flowise funcione correctamente.

Paso 1: Abrir la Terminal o Símbolo del Sistema

El primer paso es abrir una ventana de línea de comandos. Dependiendo de tu sistema operativo, esta se llama:

• En Mac o Linux: Terminal (puedes buscarla con Spotlight o en tus aplicaciones).
• En Windows: Símbolo del sistema (o CMD). Puedes encontrarla buscando «cmd» en el menú de inicio.

Paso 2: Comprobar que tienes Node.js y NPM

Flowise necesita que Node.js esté instalado en tu sistema para funcionar. Para verificar si ya lo tienes, escribe el siguiente comando en tu terminal y pulsa Enter:

node -v

¿Qué puede pasar?

• Si ves un número de versión (por ejemplo: v22.17.0): ¡Perfecto! Ya tienes Node.js instalado
• Si aparece un mensaje de error o el comando no se reconoce: Necesitas instalar Node.js primero

Paso 3: Instalar Node.js (si no lo tienes o si quieres actualizarlo)

Si no tienes Node.js instalado, sigue estos pasos:

1. Ve a la página oficial: nodejs.org
2. Descarga la versión recomendada (LTS)
3. Ejecuta el instalador y sigue las instrucciones
4. Una vez terminado, vuelve a verificar con node -v

Verificar NPM

Cuando instalas Node.js, también se instala automáticamente NPM (Node Package Manager). NPM es como una tienda de aplicaciones para herramientas de desarrollo. Verifica que esté instalado:

npm -v

Deberías ver un número de versión.

Paso 4: Instalar Flowise

Ahora que tienes Node.js y NPM, puedes instalar Flowise. Escribe este comando en tu terminal:

npm install -g flowise@latest

¿Qué significa este comando?

• npm install: Le dice a NPM que instale una aplicación
• -g: Significa «global», para que puedas usar Flowise desde cualquier carpeta
• flowise: Es el nombre de la aplicación que queremos instalar

El proceso de instalación puede tomar unos minutos. ¡Ten paciencia!

Paso 5: Verificar la instalación

Para comprobar que Flowise se instaló correctamente, escribe:

flowise

Si ves información sobre la versión y comandos disponibles, ¡la instalación fue exitosa!

Paso 6: Iniciar Flowise

Para comenzar a usar Flowise, necesitas iniciar el servidor. Escribe este comando:

npx flowise start

¿Qué significa este comando?

• npx: Es el ejecutor de paquetes de Node.js
• flowise start: Le dice a Flowise que inicie el servidor

Verás un mensaje que dice algo como «Server listening on port 3000» (El servidor está escuchando en el puerto 3000).

Paso 7: Acceder a Flowise

Una vez que el servidor esté funcionando:

1. Abre tu navegador web (Chrome, Firefox, Safari, etc.)
2. Ve a la dirección: localhost:3000
3. Verás la página de inicio de Flowise donde puedes crear una cuenta o iniciar sesión

¡Felicidades! Ya tienes Flowise funcionando en tu computadora.

Modo de Depuración (Opcional)

Si en algún momento tienes problemas con Flowise y necesitas más información sobre lo que está pasando, puedes activar el modo de depuración.

Cómo activar el modo de depuración:

1. Primero, detén Flowise presionando Ctrl + C (o Cmd + C en Mac)
2. Luego inicia Flowise con modo de depuración:

DEBUG=true npx flowise start

En este modo, verás mucha más información en la terminal sobre todo lo que está haciendo Flowise. Esto es útil para identificar problemas.

Comandos Útiles – Resumen

Aquí tienes un resumen de todos los comandos importantes:

# Verificar Node.js
node -v

# Verificar NPM
npm -v

# Instalar Flowise
npm install -g flowise@latest

# Verificar instalación de Flowise
flowise

# Iniciar Flowise
npx flowise start

# Iniciar Flowise con depuración
DEBUG=true npx flowise start

# Detener Flowise
Ctrl + C

Consejos Adicionales

1. Mantén la terminal abierta: Mientras uses Flowise, la terminal debe permanecer abierta
2. Guarda tu trabajo: Siempre guarda tus flujos de trabajo antes de cerrar Flowise
3. Actualizar Flowise: Para actualizar a una nueva versión, usa npm install -g flowise@latest nuevamente

Solución de Problemas Comunes

Problema: «node no se reconoce como comando»

Solución: Node.js no está instalado o no está en el PATH del sistema. Reinstala Node.js.

Problema: «Permission denied» o errores de permisos

Solución: En Mac/Linux, prueba con sudo npm install -g flowise

Problema: El puerto 3000 está ocupado

Solución: Otro programa está usando el puerto 3000. Cierra otras aplicaciones o reinicia tu computadora.

Conclusión

¡Excelente trabajo! Ahora tienes Flowise instalado y funcionando en tu ordenador. En el próximo módulo, aprenderemos a navegar por la interfaz de Flowise y crear nuestro primer agente de IA.

Recuerda: si tienes algún problema durante la instalación, el modo de depuración te ayudará a identificar qué está pasando exactamente.