BeatDesign

Plataforma de medios local-primero y de código abierto con IA, que incluye lienzo, editor de video, recursos y control MCP.

Documentación

BeatDesign — one local creative workspace, controlled by any MCP-capable agent

BeatDesign

Un espacio de trabajo creativo local. Cualquier agente.
Genera en un lienzo, edita en una línea de tiempo y deja que un agente compatible con MCP opere el mismo proyecto a tu lado.

Sitio web · Inicio rápido · MCP · Estado del producto · 中文

BeatDesign es un banco de trabajo de medios con IA gratuito, de código abierto y local primero. Combina un Estudio guiado, un Lienzo infinito, un Editor de video de formato corto y una biblioteca de Activos compartida dentro de un único Proyecto local.

El navegador es tu espacio de trabajo visual. Un Agente como Codex, Claude Code, Cursor u otro host compatible con MCP puede leer y modificar el mismo Proyecto a través de las 20 herramientas locales de BeatDesign. Los Agentes de codificación genéricos usan stdio local; QwenWork y Doubao Work pueden usar el endpoint HTTP Streamable local. No hay sistema de cuentas, suscripción, libro de créditos local ni panel de administración en este repositorio.

El bucle creativo

Prompt or local media
        ↓
Studio / Canvas ── generate, branch, connect, reuse
        ↓
Shared Assets ─── image, video, audio, extracted clip, render
        ↓
Editor ────────── trim, split, move, mix, AI redo, export MP4
        ↑
Any MCP Agent ─── inspect and apply project-level commands

El resultado es un flujo de trabajo continuo en lugar de generadores de IA separados, carpetas de descargas y herramientas de edición.

Un Proyecto, cuatro vistas

VistaPara qué sirve
EstudioGeneración de imágenes/videos priorizando el prompt y análisis de video Estándar o Profundo.
LienzoNodos de medios conectados, historial de generación, referencias, ramificaciones y salidas reutilizables.
EditorUna línea de tiempo local de formato corto para video, imágenes fijas y audio, con edición no destructiva y exportación MP4.
ActivosLa fuente de verdad a nivel de proyecto compartida por Estudio, Lienzo, Editor y MCP.

Por qué se siente diferente

  • Local por defecto. Los Proyectos, instantáneas del Lienzo, líneas de tiempo, historial de generación y medios importados permanecen en el espacio de trabajo local.
  • Nativo para agentes, no bloqueado por agentes. BeatDesign expone transportes MCP estándar stdio y Streamable HTTP en lugar de incrustar un chatbot propietario.
  • Activos primero. Los medios generados e importados se convierten en Activos estables del proyecto antes de colocarse en el Lienzo o el Editor.
  • Una sola ruta de comandos. Las escrituras de la UI y MCP pasan por el mismo Kernel de Comandos, verificaciones de revisión y recibos persistidos.
  • Sin configuración de FFmpeg del sistema. La vista previa y la exportación MP4 usan WebCodecs y Mediabunny nativos del navegador.
  • El límite del proveedor es explícito. BeatAPI es el adaptador de generación integrado; las bifurcaciones pueden registrar su propio adaptador sin reescribir el Lienzo o el Editor.

Inicio rápido

Requisitos: Node.js 22+, pnpm 10+ y Chrome actual en macOS o Windows.

pnpm install
pnpm db:push
pnpm dev

Abre http://127.0.0.1:3020.

La importación local, el trabajo en el Lienzo, la edición de la línea de tiempo, la vista previa y la exportación MP4 no requieren una clave de API. Agrega tu propia clave de API de BeatAPI solo cuando quieras generar, analizar medios o usar rehacer con IA.

Control del agente a través de MCP

BeatDesign ejecuta el espacio de trabajo visual más un transporte de control de Agente sobre la misma base de datos SQLite:

ProcesoComandoRol
Espacio de trabajo visualpnpm devAbre Estudio, Lienzo, Editor y Activos en el navegador.
Plano de control del agentepnpm --silent mcpExpone herramientas a nivel de proyecto a través de stdio.
Conector HTTPpnpm --silent mcp:httpExpone /mcp en 127.0.0.1:3031 para QwenWork y Doubao Work.

Ejecuta el plano de control stdio para Agentes de codificación, o el conector HTTP para conectores de oficina; normalmente no necesitas ejecutar ambos.

El repositorio incluye un .mcp.json raíz para hosts compatibles y un lanzador delgado de Codex bajo integrations/codex/beatdesign.

Las 20 herramientas están agrupadas por conceptos de producto duraderos:

  • Proyecto (3): listar, leer, crear.
  • Activo (3): listar, leer, importar un archivo local de imagen/video/audio.
  • Lienzo (3): leer, buscar, aplicar operaciones incrementales.
  • Generación (5): descubrir modelos y parámetros, enviar, actualizar estado, leer historial.
  • Editor (6): leer, editar, inspeccionar una instantánea semántica, diagnosticar, enlazar profundamente una vista, leer historial de comandos.

MCP no automatiza píxeles de la UI. El Agente lee el Proyecto, aplica comandos estables y BeatDesign actualiza el Lienzo o Editor visible desde el mismo estado local.

Consulta Configuración de MCP y límites de herramientas.

Qué funciona hoy

Lienzo y generación

  • Nodos de Lienzo orientados a imagen, video, audio, línea de tiempo y texto.
  • Configuración de prompt/modelo/parámetros desde un catálogo BeatAPI definido en código.
  • Referencias de Activos, flujos de trabajo conectados, historial de generación y salidas persistidas localmente.
  • Generación de imagen/video más análisis de video Estándar y Profundo.
  • Transferencia de Lienzo a Editor a través de Activos compartidos y nodos de línea de tiempo.

Editor local

  • Clips de video, imágenes fijas y audio en una línea de tiempo compartida.
  • Arrastrar para recortar, dividir, mover, eliminar, eliminar con ondulación y edición de duración de imágenes fijas.
  • Deshacer/rehacer, reproducción, selección de rango de origen, volumen de audio y fundidos.
  • Rehacer con IA de rango seleccionado como Tomas no destructivas.
  • Diagnósticos de línea de tiempo para huecos, superposiciones, medios faltantes, desajustes de duración y clips diminutos.
  • Exportación MP4 H.264/AAC del lado del navegador; los renders completados regresan a los Activos del proyecto.

Persistencia local

  • Datos del proyecto SQLite bajo data/.
  • Medios propiedad del proyecto bajo data/project-assets/<project-id>/.
  • Guardado de Lienzo y Editor consciente de revisiones.
  • UI en inglés y chino.

Datos y límite del proveedor

Browser UI / MCP
      ↓
Command Kernel + Project services
      ↓
SQLite + data/project-assets
      ↓ only after a confirmed generation request
Generation adapter (BeatAPI by default)
      ↓
Output copied back into the local Asset library

Las claves de API y las credenciales opcionales de R2/S3 están cifradas en el espacio de trabajo SQLite local. Seleccionar o arrastrar un archivo local no lo envía a un proveedor. BeatDesign persiste el archivo localmente primero y sube solo el Activo de proyecto duradero requerido por una solicitud de generación confirmada. BeatAPI Files es la ruta de subida predeterminada; los usuarios pueden seleccionar su propio bucket público compatible con R2/S3 en Conexiones.

BeatDesign no reproduce la facturación, el saldo ni la lógica de límites de tasa del proveedor. Devuelve el resultado o error del proveedor al llamador de UI/MCP. El repositorio upstream incluye el adaptador oficial de BeatAPI; una bifurcación puede implementar BaseAdapter, registrarlo y seleccionarlo en src/config/generation-providers.ts.

Lee arquitectura del proveedor y arquitectura del sistema para el contrato completo.

Límites actuales de v0.2

BeatDesign v0.2 se centra en flujos de trabajo locales de video de IA de formato corto:

  • Chrome actual en macOS y Windows.
  • Imágenes comunes decodificables por el navegador, video MP4/MOV y audio MP3/WAV/M4A/AAC/OGG.
  • Una línea de tiempo activa por Proyecto y exportación limitada por memoria del navegador.
  • Lienzo y Editor consultan revisiones del Agente cada dos segundos; un bus de eventos en tiempo real aún no está implementado.
  • La instantánea MCP del Editor es inspección semántica, no un marco de píxeles renderizado.
  • Subtítulos, transiciones, controles de velocidad, formas de onda, múltiples líneas de tiempo nombradas y empaquetado nativo de escritorio siguen siendo trabajo futuro.

El límite completo completado/planificado está en Plan de producto y estado.

Comandos para desarrolladores

ComandoPropósito
pnpm devInicia la aplicación local en 127.0.0.1:3020.
pnpm --silent mcpInicia el servidor MCP local a través de stdio.
pnpm typecheckVerifica los contratos de TypeScript.
pnpm testEjecuta pruebas unitarias y de contrato.
pnpm i18n:checkValida mensajes en inglés y chino.
pnpm buildCompila la aplicación de producción.
pnpm db:pushAplica el esquema SQLite local durante el desarrollo.
pnpm media:localizeCopia medios alojados por el proveedor en instantáneas existentes al almacenamiento local del proyecto.

Contribuciones

Comienza con CONTRIBUTING.md, luego usa:

Licencia

BeatDesign está licenciado bajo Apache License 2.0. La licencia cubre el código, no las marcas comerciales de BeatAPI, el acceso al servicio, los derechos de los modelos de proveedores ni los activos de terceros. El contrato de línea de tiempo se deriva de OpenReel con licencia MIT y la canalización de medios del navegador usa Mediabunny con licencia MPL-2.0; consulta third_party/ y TRADEMARKS.md.