Stories.io - Generador Automático de Vídeos Cortos

Stories.io (antes Antigravity) es una plataforma y motor local en Node.js y React diseñado para automatizar completamente la creación de vídeos cortos para redes sociales (TikTok, Reels, Shorts).

La aplicación toma un texto (o extrae una historia directamente de un enlace o Subreddit), genera una voz neuronal súper realista, la transcribe a subtítulos dinámicos de alta precisión, y ensambla el resultado sobre un vídeo de fondo (gameplay) con una personalización visual "Pixel-Perfect".

✨ Funcionalidades Principales

Dashboard Visual Completo: Interfaz en React (Vite) donde puedes gestionar todo visualmente sin tocar la terminal.
Generación Masiva: Capacidad de raspar (scrape) los posts más virales de cualquier Subreddit y añadirlos a una cola para generar múltiples vídeos de forma automática con un solo clic.
Voz a Texto (TTS) Premium y Gratuita: Utiliza la API de Microsoft Edge TTS para conseguir voces neuronales extremadamente naturales en múltiples idiomas y acentos (incluyendo Español de España, Español LATAM, e Inglés), totalmente gratis y sin keys.
Transcripción IA Local: Integración nativa con Whisper.cpp para que tu ordenador genere los subtítulos y los tiempos (timestamps) con precisión milimétrica de forma local, sin pagar APIs externas (como OpenAI).
Traducción CSS-to-Video Exacta: El editor visual de subtítulos de la web (fuentes, tamaños, contornos masivos, sombras y mayúsculas) se traduce de forma matemática y exacta al motor de renderizado del vídeo final (libass/FFmpeg). Lo que ves en la web, es exactamente lo que sale en el MP4.

⚙️ Instalación y Requisitos

La herramienta está pensada para correr 100% en local. Para que el programa funcione, necesitas tener Node.js instalado y preparar dos herramientas clave en tu ordenador: FFmpeg y Whisper.cpp.

Paso 1: Dependencias del Sistema

FFmpeg es el motor que mezcla el audio y el vídeo. Debe estar instalado en tu sistema:

En macOS: Abre la terminal y ejecuta brew install ffmpeg (suele venir con soporte libass por defecto, que es obligatorio para quemar subtítulos).
En Windows: Descarga el binario oficial y añádelo a las Variables de Entorno del sistema.

Paso 2: Ejecutar el Script de Instalación Automática

He preparado un script que se encarga de instalar todo automáticamente en tu ordenador (Node.js modules, clonar Whisper.cpp, compilar la IA local, descargar el modelo y configurar las rutas absolutas).

Clona este repositorio y abre una terminal en la carpeta principal.

git clone https://github.com/Alexgmatosc/stories.io.git
cd stories.io

Ejecuta el script mágico de instalación:
```
./install.sh
```
(Si te da un error de permisos, ejecuta primero chmod +x install.sh).

Paso 3: Preparar tus Vídeos de Fondo (B-Roll)

El programa necesita vídeos largos para poner de fondo (gameplays de Minecraft, GTA, etc.).

Guárdalos manualmente en formato .mp4 en la carpeta assets/b-roll/.
(También puedes poner URLs de YouTube en el archivo broll_urls.txt y correr npm run download-broll para automatizar la descarga).

🚀 Cómo Iniciar la Aplicación

Para abrir el panel visual interactivo y arrancar el motor de generación, simplemente abre dos terminales en tu proyecto:

Terminal 1 (Backend):

# Arranca el servidor API local en el puerto 3001
npm run server

Terminal 2 (Frontend):

cd client
# Arranca la web visual interactiva
npm run dev

Abre tu navegador en la URL que te diga Vite (normalmente http://localhost:5173) y empieza a generar vídeos. ¡El panel lo hará todo automático por ti!