YoloCut

Eine neue Art von Videobearbeitung

YoloCut ist ein lokaler Desktop-Editor, in dem ein Mensch und ein Agent am selben echten Projekt arbeiten. Clips auf der Timeline trimmen und anordnen – oder den integrierten Agenten, Codex, Claude Code, Gemini CLI, Cursor oder einen anderen MCP-Client bitten, dieselben Bearbeitungsbefehle zu verwenden.

Dies ist kein Einmal-Videogenerator, der ein undurchsichtiges Ergebnis liefert. Agent-Arbeit wird zu normalen Medien, Spuren, Clips, Untertiteln, Übergängen, Effekten, Keyframes und Exportaufträgen. Du kannst sie in der Vorschau ansehen, die vorgeschlagenen Änderungen prüfen, übernehmen oder ablehnen, rückgängig machen und von Hand weiterbearbeiten.

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

Related MCP server: Cutible MCP Server

Warum YoloCut

Produktübersicht

Alle obigen Screenshots wurden aus der aktuellen YoloCut-Desktopanwendung v0.0.2 aufgenommen.

Was in v0.0.2 verfügbar ist

Von Grund auf agent-nativ

Der abkoppelbare Agent-Arbeitsbereich ist eine Steueroberfläche, keine dekorative Chat-Seitenleiste:

• Er teilt Projektzustand und Bearbeitungsbefehle mit der manuellen Oberfläche.

• Er kann links oder rechts andocken, als separates breites Desktop-Fenster geöffnet werden und über Eck-Andocken zum Editor zurückkehren.

• Verändernde Arbeit wird in einer Bearbeitungssitzung zwischengespeichert und vor der Übernahme zur Prüfung vorgelegt.

• Der integrierte Agent und externe MCP-Clients verwenden denselben kanonischen 119-Tool-Katalog.

• Wenn kein Projekt geöffnet ist, legt YoloCut nur die kleinere Server-Direktfläche offen und meldet die Einschränkung ehrlich.

Einen externen Agenten verbinden

Installiere die YoloCut-Agent-Skill:

npx skills add Hhz0823/YoloCut --skill yolocut

Starte YoloCut, öffne das Zielprojekt und öffne dann das Agent-Verbindungszentrum (MCP) und kopiere dessen Live-URL und Bearer-Token. Der Standard-Endpunkt ist:

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

Die Desktopanwendung kann einen anderen Loopback-Port wählen, wenn 5199 belegt ist. Clients sollten daher die vom Verbindungszentrum angezeigte Adresse verwenden, anstatt den Standardwert dauerhaft fest zu codieren.

Erforderlicher Abschluss-Ablauf:

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)

Ein Agent sollte den Abschluss nur melden, wenn die vollständige Bearbeitung bereit ist, die Fähigkeitsabdeckung vollständig ist und die endgültige Bearbeitungssitzung applied ist. Konfigurationsbeispiele für Codex, Claude Code, Gemini CLI, Cursor und generische Streamable-HTTP-Clients findest du in YOLOCUT_AGENT_CONNECTION.md.

Stapelweise automatische Bearbeitung

Gib YoloCut ein Medienverzeichnis, ein Bearbeitungsskript, ein Erzählskript und optional ein Referenzvideo. Die dauerhafte Warteschlange akzeptiert bis zu 10.000 Aufträge, mit einem separaten Projekt und Lebenszyklus für jede Ausgabe, anstatt Tausende von Videos auf einer Timeline zu platzieren.

1. Ein autorisiertes lokales Medienverzeichnis scannen.

2. Bearbeitungsskript, Erzählskript und optionalen Referenzschnitt anhängen.

3. Rhythmus, Schnittstruktur, Untertitel, Übergänge und Farbabsicht analysieren.

4. Den Agenten prüfbare Bearbeitungen mit hardware-bewusster Parallelität erstellen lassen.

5. Rendern, Qualitätsprüfung und Rückmeldung von Erfolg, Fehler oder Abbruch pro Auftrag.

Die optionale lokale Referenzanalyse verwendet das Apache-2.0-Paket SmolVLM2-500M-Video-Instruct-GGUF mit llama.cpp. Fehlende Modelle oder Laufzeiten schlagen sichtbar fehl; YoloCut erfindet kein Analyseergebnis.

Lange 4K-Projekte auf bescheidenen Rechnern

YoloCut trennt den interaktiven Proxy-Pfad von Medien in Endqualität. Analyse und Vorschau können kleinere Ableitungen verwenden, während der finale Export die Originaldateien liest.

• NVIDIA-Systeme bevorzugen NVDEC → scale_cuda → NVENC nach Live-Fähigkeitsprüfungen.

• Das H.264-Routing prüft NVENC, Intel QSV, AMD AMF und dann Software-libx264.

• AV1, VP9 und nicht unterstützte Hardware-Pfade können auf FFmpeg-Software-Decoder wie libaom-av1 und libvpx zurückfallen.

• CPU, Speicher, VRAM, Codec-Unterstützung und aktive Arbeitslast bestimmen Proxy-Größe und Warteschlangen-Parallelität.

• Laufzeitergebnisse zeigen das tatsächlich verwendete Backend und jeden Fallback-Grund; Modell- oder GPU-Namen allein gelten nie als Beweis.

Die Gewichte des Fish-S2-Modells unterliegen der Fish Audio Research License. Die kommerzielle Nutzung erfordert eine separate schriftliche Genehmigung. Hardware-Stufen sind konservative Richtlinienverträge, keine Leistungsgarantien für jeden Treiber und jeden Rechner.

Schnellerer Desktop-Start

YoloCut v0.0.2 staffelt den Desktop-Start nun, anstatt das erste Fenster mit dem vollständigen Bearbeitungs-Stack zu blockieren:

• Electron zeigt eine leichte native Start-Shell, bevor der eingebettete Anwendungsserver geladen wird.

• Der Server startet parallel, während die GPU-Erkennung asynchron weiterläuft, nachdem der Editor nutzbar geworden ist.

• Modelle, Thumbnails, Updater-Prüfungen und die gepackte Render-Laufzeit werden verzögert, bis die jeweilige Funktion oder das Fenster nach dem Start sie benötigt.

• Renderer-Oberflächen und Dashboard-Dialoge bleiben hinter Lazy-Grenzen, sodass der vollständige Editor-Graph nicht Teil des anfänglichen Dashboard-Ladens ist.

• Desktop-Smoke-Tests verwenden ein eindeutiges temporäres Profil und Datenverzeichnis, sodass Tests niemals die Projekte, Anmeldedaten, Medien oder den laufenden YoloCut-Prozess eines Benutzers berühren.

Auf dem Windows-Release-Verifizierungsrechner zeigte der entpackte Build seine native Shell in etwa 85 ms, startete den eingebetteten Server in etwa 0,72 s und lud den ersten Renderer bei einem Kaltstart in etwa 2,79 s; ein aufgewärmter Renderer lud in etwa 0,51 s. Dies sind diagnostische Messwerte von einem einzelnen Rechner, keine geräteübergreifenden Garantien. Setzen Sie YOLOCUT_STARTUP_TRACE=1 beim Start des Desktop-Builds, um die Phasenzeiten für ein anderes System auszugeben.

Download

Die GitHub-Release-Assets enthalten absichtlich nur die direkt installierbaren Windows-.exe- und macOS-.dmg-Dateien. Die SHA-256-Werte der Installationsprogramme sind in den Release-Notizen aufgeführt und werden nicht als weiteres Asset angehängt. Windows-Pakete sind derzeit nicht signiert; macOS-Pakete sind ad-hoc signiert, aber nicht notarisiert.

Linux wird weiterhin in CI gebaut und rauchgetestet, aber nicht an GitHub Releases angehängt. Linux-Benutzer können YoloCut mit den folgenden Anweisungen aus dem Quellcode ausführen. Gepackte Builds verwenden die In-App-Versionsprüfung und öffnen die GitHub-Release-Seite für die manuelle Installation, wenn ein Update verfügbar ist.

Aus dem Quellcode ausführen

Erfordert Node.js >=24 <25 und npm.

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

Desktop-Entwicklung und Windows-Packaging:

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

Entwicklungsprofile isolieren Projekte, Medien, Anmeldedaten, Aufgaben und Einstellungen pro Git-Checkout/Worktree. Konfigurieren Sie nur die KI- oder Medienanbieter, die Sie tatsächlich verwenden möchten.

Daten und Sicherheit

• Projekte, Chat, Versionen, Indizes und Einstellungen sind standardmäßig lokal unter ~/.yolocut gespeichert.

• Vorhandene Legacy-Datenwurzeln können von der Migrationsschicht eingebunden werden, sodass Benutzer frühere Projekte nicht verlieren.

• Anbieterschlüssel bleiben auf der Dienstseite und werden nicht über VITE_-Browser-Variablen offengelegt.

• MCP bindet standardmäßig an Loopback und erfordert ein generiertes Bearer-Token.

• Der Verzeichniszugriff verwendet undurchsichtige Berechtigungen; absolute lokale Pfade überschreiten die Desktop-IPC-Grenze nicht in Agent-Tools.

• KI-Datenverkehr verlässt den Computer nur für Anbieter, die der Benutzer explizit konfiguriert.

• YoloCut zielt auf einen Single-User-Desktop-Workflow ab, nicht auf eine nicht isolierte Multi-Tenant-Serverbereitstellung.

Architektur und Verifizierung

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

Aktuelle Release-Grenzen

YoloCut 0.0.2 ist eine frühe öffentliche Version. Kernbearbeitung, Agent, MCP, Batch, Desktop-Packaging und lokale Modellverwaltung werden aktiv verifiziert, aber mehrere Oberflächen bleiben experimentell:

• Fish S2, SmolVLM2 und einige GPU-Pfade hängen von lokalen Laufzeiten und Treibern ab.

• Das Projektformat und der Agent-Katalog werden sich weiterentwickeln; sichern Sie wichtige Projekte vor Upgrades.

• Signierung und Notarisierung sind noch nicht produktionsreif.

• Für die jeweilige KI-Funktion ist ein konfigurierter Anbieter oder ein installiertes Modell erforderlich; die manuelle Bearbeitung bleibt ohne eines verfügbar.

Siehe CHANGELOG.md für den Versionsverlauf und GitHub Releases für veröffentlichte Artefakte.

Lizenz, Herkunft und Mitwirkung

YoloCut wird unabhängig von hhz0823 gepflegt und ist unter der GNU Affero General Public License v3.0 oder später lizenziert.

Die Codebasis geht auf das AGPL-lizenzierte Projekt 0xsline/OpenChatCut zurück. Diese Zuordnung bewahrt die Quell- und Lizenzherkunft; Upstream-Branding, Mitwirkende, Community-Kanäle und kommerzielle Beziehungen sind nicht Teil des YoloCut-Produkts oder seiner öffentlichen Release-Historie.

Drittanbieter-Bibliotheken, Modelle, Schriftarten, Skills und gebündelte Binärdateien behalten ihre eigenen Lizenzen. Siehe THIRD_PARTY_NOTICES.md, src/agent/skills/NOTICE.md und assets/fonts/LICENSES.md.

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

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

• Agent-Anleitung: YOLOCUT_AGENT_CONNECTION.md