openstory

OpenStory es una plataforma de código abierto para convertir un guion escrito en una producción de vídeo con estilo. Analiza el guion en un desglose de escenas con ángulos de cámara, tratamientos de ambiente y seguimiento de continuidad, y luego genera una secuencia de fotogramas de IA —imágenes, vídeo en movimiento y audio— mientras mantiene coherentes los personajes, las localizaciones, las paletas de color y la iluminación entre escenas. El proyecto se describe a sí mismo como encargado de la ingeniería de prompts, la generación y la composición para que los equipos puedan centrarse en el trabajo creativo. Capacidades clave descritas en el README: - Análisis de guiones: pega un guion y recibe un desglose automático de escenas con ángulos de cámara, tratamientos de ambiente y seguimiento de continuidad. - Generación de imágenes con IA mediante Fal.ai, con múltiples opciones de modelos. - Movimiento de imagen a vídeo: convierte fotogramas fijos en clips de vídeo en movimiento. - Coherencia de estilo: los personajes, las localizaciones, las paletas de color y la iluminación se mantienen automáticamente entre escenas. - Los espacios de trabajo para equipos figuran como próximamente, con bibliotecas compartidas de estilos, personajes, VFX y audio. - Autenticación con passkey mediante Better Auth para inicio de sesión sin contraseña. - Despliegue en el edge en Cloudflare Workers con una CDN global. Arquitectura y stack: la aplicación está construida con TanStack Start, TanStack Router y Vite, y se ejecuta en Bun (versión 1.3.9 o superior). Los datos se almacenan en Cloudflare D1 (SQLite) mediante Drizzle ORM. Las funciones de IA usan TanStack AI, Fal.ai y OpenRouter, con PostHog para observabilidad de LLM. La generación de larga duración se gestiona con Cloudflare Workflows para una ejecución duradera, mientras que Cloudflare Durable Objects proporcionan actualizaciones de progreso SSE en tiempo real. Los recursos se alojan en Cloudflare R2 (compatible con S3). La interfaz de usuario usa Tailwind v4 y shadcn/ui. Las herramientas de calidad incluyen oxlint, oxfmt, tsgo, Lefthook y Knip; las pruebas usan Vitest y Playwright. Para empezar solo se necesita Bun. El desarrollo local ejecuta todo el stack —D1, R2, Workflows, Durable Objects y correo electrónico— dentro de Workerd mediante Miniflare, por lo que no se necesita Docker, una base de datos externa ni una cuenta de Cloudflare. Después de clonar y ejecutar bun install, bun dev inicializa .env.local con secretos de autenticación y cifrado, migra y siembra la base de datos local, e inicia el servidor de desarrollo en el puerto 3000. La generación con IA requiere dos claves: FAL_KEY para la generación de imágenes, vídeo y audio, y OPENROUTER_KEY para el análisis de guiones con LLM; bun setup las añade de forma interactiva. La configuración opcional abarca Google OAuth, Stripe, PostHog y R2 remoto. El repositorio documenta un amplio conjunto de scripts para desarrollo, comprobaciones de calidad, pruebas, migraciones de base de datos y despliegue. El despliegue está dirigido a Cloudflare Workers, con un botón de despliegue en un clic que clona el repositorio, aprovisiona los recursos declarados en wrangler.jsonc y configura CI. Cloudflare Workers Builds despliega automáticamente al hacer push a main, y las pull requests reciben despliegues de vista previa de GitHub Actions con bases de datos D1 dedicadas. El proyecto tiene licencia MIT y acepta contribuciones, y orienta a los recién llegados hacia las etiquetas good first issue y una guía CONTRIBUTING.