Guía de Instalación y Setup Local

Esta guía explica cómo levantar Streamlyra en tu máquina local desde cero.

Requisitos Previos

Asegúrate de tener instalado:

bash

git clone https://github.com/ElSantanax/Streamlyra.git
cd Streamlyra

Crea los archivos de configuración en blanco en las carpetas correspondientes:

Para obtener las claves de base de datos (Neon), Twitch y YouTube, sigue nuestra:

IMPORTANTE

Solo necesitas completar las variables de base de datos y secretos (JWT_SECRET, ENCRYPTION_KEY) para que el sistema logre arrancar inicialmente.

bash

# Instalar dependencias del servidor
cd server && npm install

# Instalar dependencias del cliente
cd ../client && npm install

bash

# Desde la carpeta /server
npm run dev

Streamlyra creará automáticamente las tablas en la base de datos en el primer arranque (sincronización de Sequelize en modo alter).

Si el arranque fue exitoso, verás en la consola:

Base de datos conectada
Servidor HTTP escuchando en puerto 3000
Socket.io inicializado

En otra terminal:

bash

# Desde la carpeta /client
npm run dev

El cliente estará disponible en http://localhost:5173 por defecto.

Webhooks en local: Para recibir webhooks de Twitch/Kick en tu máquina, necesitas exponer el puerto 3000 con una herramienta como ngrok o Cloudflare Tunnel. Actualiza SERVER_URL con la URL generada.
YouTube en local: Las cuotas están desactivadas automáticamente en NODE_ENV=development. No necesitas preocuparte por los límites mientras desarrollas.
TikTok: No requiere ninguna credencial de API. Solo necesitas un username válido de TikTok.

bash

# Desde la carpeta /server
npm test

# Con cobertura
npm run test:coverage