YoloCut

Un nuevo tipo de editor de vídeo

YoloCut es un editor de escritorio local-first en el que un humano y un agente trabajan en el mismo proyecto real. Recorta y organiza clips en la línea de tiempo, o pide al agente integrado, a Codex, a Claude Code, a Gemini CLI, a Cursor o a otro cliente MCP que use los mismos comandos de edición.

No es un generador de vídeo de un solo uso que devuelve un resultado opaco. El trabajo del agente se convierte en material multimedia, pistas, clips, subtítulos, transiciones, efectos, fotogramas clave y trabajos de exportación normales. Puedes previsualizarlo, revisar los cambios propuestos, aplicarlos o rechazarlos, deshacerlos y seguir editando a mano.

Media + script + editing goal
        ↓
Agent creates a reviewable edit session
        ↓
Real timeline changes → preview → refine → export

Related MCP server: Cutible MCP Server

Por qué YoloCut

Recorrido por el producto

Todas las capturas de pantalla anteriores se tomaron de la aplicación de escritorio YoloCut v0.0.2 actual.

Qué incluye v0.0.2

Diseñado de forma nativa para agentes

El espacio de trabajo de agente desacoplable es una superficie de control, no un panel de chat decorativo:

• Comparte el estado del proyecto y los comandos de edición con la interfaz manual.

• Puede acoplarse a la izquierda o a la derecha, abrirse como una ventana de escritorio amplia independiente y volver al editor mediante el acoplamiento en esquinas.

• El trabajo que modifica se organiza en una sesión de edición para su revisión antes de considerarse aplicado.

• El agente integrado y los clientes MCP externos usan el mismo catálogo canónico de 119 herramientas.

• Cuando no hay ningún proyecto abierto, YoloCut expone solo la superficie más pequeña de servidor directo e informa de la limitación con honestidad.

Conectar un agente externo

Instala la habilidad de agente de YoloCut:

npx skills add Hhz0823/YoloCut --skill yolocut

Inicia YoloCut, abre el proyecto de destino y luego abre el Centro de conexión de agentes (MCP) y copia su URL en vivo y su token Bearer. El endpoint predeterminado es:

http://localhost:5199/api/external-mcp/mcp

La aplicación de escritorio puede elegir otro puerto de bucle local cuando el 5199 esté ocupado, por lo que los clientes deben usar la dirección que muestra el centro de conexión en lugar de codificar permanentemente el predeterminado.

Flujo de finalización requerido:

yolocut_status → get_connection_manifest → list_projects → target_project
→ load_skill / ToolSearch → begin_edit_session → editing tools
→ review_edit_session → get_edit_session (status=applied)

Un agente debe informar de la finalización solo cuando la edición completa esté lista, la cobertura de capacidades esté completa y la sesión de edición final esté applied. Los ejemplos de configuración para Codex, Claude Code, Gemini CLI, Cursor y clientes Streamable HTTP genéricos están en YOLOCUT_AGENT_CONNECTION.md.

Autoedición por lotes

Dale a YoloCut un directorio de material, un guion de edición, un guion de narración y un vídeo de referencia opcional. La cola duradera acepta hasta 10 000 trabajos, con un proyecto y un ciclo de vida independientes para cada salida, en lugar de colocar miles de vídeos en una sola línea de tiempo.

1. Escanea un directorio de material local autorizado.

2. Adjunta el guion de edición, el guion de narración y el corte de referencia opcional.

3. Analiza el ritmo, la estructura de planos, los subtítulos, las transiciones y la intención de color.

4. Deja que el agente cree ediciones revisables con concurrencia consciente del hardware.

5. Renderiza, comprueba la calidad y lee el éxito, el fallo o la cancelación de cada trabajo.

El análisis de referencia local opcional usa el paquete SmolVLM2-500M-Video-Instruct-GGUF con licencia Apache-2.0 con llama.cpp. Los modelos o entornos de ejecución que falten fallan de forma visible; YoloCut no inventa un resultado de análisis.

Proyectos 4K largos en máquinas modestas

YoloCut separa la ruta de proxy interactiva del material de calidad final. El análisis y la vista previa pueden usar derivados más pequeños mientras que la exportación final lee los archivos originales.

• Los sistemas NVIDIA prefieren NVDEC → scale_cuda → NVENC después de sondeos de capacidad en vivo.

• El enrutamiento H.264 sondea NVENC, Intel QSV, AMD AMF y luego el libx264 de software.

• AV1, VP9 y las rutas de hardware no compatibles pueden recurrir a descodificadores de software de FFmpeg como libaom-av1 y libvpx.

• La CPU, la memoria, la VRAM, la compatibilidad con códecs y la carga de trabajo activa deciden el tamaño del proxy y la concurrencia de la cola.

• Los resultados del entorno de ejecución muestran el backend que se usó realmente y cualquier motivo de la alternativa; los nombres de modelos o GPU por sí solos nunca se tratan como prueba.

Los pesos del modelo Fish S2 usan la licencia de investigación de Fish Audio. El uso comercial requiere permiso escrito por separado. Los niveles de hardware son contratos de política conservadores, no garantías de rendimiento para cada controlador y máquina.

Inicio de escritorio más rápido

YoloCut v0.0.2 ahora organiza por etapas el inicio del escritorio en lugar de bloquear la primera ventana con la pila de edición completa:

• Electron muestra un shell de inicio nativo ligero antes de cargar el servidor de aplicación integrado.

• El servidor se inicia en paralelo, mientras que la detección de GPU continúa de forma asíncrona después de que el editor sea utilizable.

• Los modelos, las miniaturas, las comprobaciones de actualizaciones y el entorno de renderizado empaquetado se difieren hasta que la función relevante o la ventana posterior al inicio los necesiten.

• Las superficies del renderizador y los diálogos del panel permanecen detrás de límites diferidos para que el grafo completo del editor no forme parte de la carga inicial del panel.

• Las pruebas de humo del escritorio usan un perfil temporal único y un directorio de datos, lo que evita que las pruebas toquen los proyectos, las credenciales, el material o el proceso de YoloCut en vivo del usuario.

En la máquina de verificación de lanzamiento de Windows, la compilación desempaquetada mostró su shell nativo en aproximadamente 85 ms, levantó el servidor integrado en aproximadamente 0,72 s y cargó el primer renderizador en aproximadamente 2,79 s en una ejecución en frío; un renderizador precalentado se cargó en aproximadamente 0,51 s. Estas son mediciones de diagnóstico de una sola máquina, no garantías entre dispositivos. Establezca YOLOCUT_STARTUP_TRACE=1 al iniciar la compilación de escritorio para imprimir los tiempos de las etapas en otro sistema.

Descarga

Los activos de GitHub Release contienen intencionalmente solo los archivos .exe de Windows y .dmg de macOS directamente instalables. Los valores SHA-256 del instalador se enumeran en las notas de la versión en lugar de adjuntarse como otro activo. Los paquetes de Windows actualmente no están firmados; los paquetes de macOS están firmados ad-hoc pero no notarizados.

Linux sigue compilándose y probándose con smoke tests en CI, pero no se adjunta a GitHub Releases. Los usuarios de Linux pueden ejecutar YoloCut desde el código fuente usando las instrucciones a continuación. Las compilaciones empaquetadas usan la verificación de versión dentro de la aplicación y abren la página de GitHub Release para la instalación manual cuando hay una actualización disponible.

Ejecutar desde el código fuente

Requiere Node.js >=24 <25 y npm.

git clone https://github.com/Hhz0823/YoloCut.git
cd YoloCut
npm install
cp .env.example .env.local
npm run dev

Desarrollo de escritorio y empaquetado de Windows:

npm run desktop:dev
npm run desktop:dist:win

Los perfiles de desarrollo aíslan proyectos, medios, credenciales, tareas y configuraciones por checkout/worktree de Git. Configure solo los proveedores de IA o medios que realmente tenga intención de usar.

Datos y seguridad

• Los proyectos, el chat, las versiones, los índices y la configuración son locales por defecto en ~/.yolocut.

• Las raíces de datos heredadas existentes pueden montarse mediante la capa de migración para que los usuarios no pierdan proyectos anteriores.

• Las claves de los proveedores permanecen en el lado del servicio y no se exponen a través de las variables de navegador VITE_.

• MCP se vincula a loopback por defecto y requiere un token Bearer generado.

• El acceso a directorios utiliza concesiones opacas; las rutas locales absolutas no cruzan el límite IPC del escritorio hacia las herramientas del Agent.

• El tráfico de IA sale de la computadora solo para los proveedores que el usuario configura explícitamente.

• YoloCut apunta a un flujo de trabajo de escritorio de un solo usuario, no a una implementación de servidor multiinquilino sin aislamiento.

Arquitectura y verificación

npm test                         # full regression suite
npm run build                    # type checking and production build
npm run lint                     # static analysis
npm run verify:architecture      # enforced dependency boundaries
npm run verify:mcp               # Agent/MCP contract checks
npm run verify:media-performance # codecs, proxies, acceleration, fallbacks
npm run verify:auto-edit         # batch auto-edit contracts
npm run desktop:smoke             # embedded server and desktop bridge
npm run desktop:smoke:render      # real packaged rendering path
npm run desktop:smoke:post-startup # deferred startup work
npm run desktop:smoke:agent-window

Límites actuales de la versión

YoloCut 0.0.2 es una versión pública temprana. La edición principal, el Agent, MCP, el procesamiento por lotes, el empaquetado de escritorio y la gestión de modelos locales se verifican activamente, pero varias superficies siguen siendo experimentales:

• Fish S2, SmolVLM2 y algunas rutas de GPU dependen de runtimes y controladores locales.

• El formato de proyecto y el catálogo del Agent continuarán evolucionando; haga copias de seguridad de los proyectos importantes antes de las actualizaciones.

• La firma y la notarización aún no están a nivel de producción.

• Se requiere un proveedor configurado o un modelo instalado para su característica de IA correspondiente; la edición manual sigue disponible sin uno.

Consulte CHANGELOG.md para el historial de versiones y GitHub Releases para los artefactos publicados.

Licencia, procedencia y contribuciones

YoloCut es mantenido de forma independiente por hhz0823 y está licenciado bajo la GNU Affero General Public License v3.0 o posterior.

El código base continúa del proyecto 0xsline/OpenChatCut con licencia AGPL. Esta atribución preserva la procedencia del código y la licencia; la marca, los contribuyentes, los canales comunitarios y las relaciones comerciales del proyecto original no forman parte del producto YoloCut ni de su historial de lanzamientos públicos.

Las bibliotecas de terceros, modelos, fuentes, skills y binarios incluidos conservan sus propias licencias. Consulte THIRD_PARTY_NOTICES.md, src/agent/skills/NOTICE.md y assets/fonts/LICENSES.md.

• Problemas: github.com/Hhz0823/YoloCut/issues

• Lanzamientos: github.com/Hhz0823/YoloCut/releases

• Guía del Agent: YOLOCUT_AGENT_CONNECTION.md