文件最后提交记录最后更新时间
3 小时前
README

OpenCreator
Der Open-Source-KI-Arbeitsbereich & Skills für Kreative

Verbinde visuelle Kreativwerkzeuge, wiederverwendbare Skills und Agents für Skripte, Videos, Bilder, Stimmen, Avatare, Übersetzungen und Bearbeitung – alles in einem Arbeitsbereich.

OpenCreator hieß früher KrillinAI.

OpenCreator (ehemals KrillinAI): Platz 1 der Repositories des Tages auf Trendshift

English | 简体中文 | 日本語 | 한국어 | Bahasa Indonesia | Español | Français | Deutsch | Português | Русский | العربية

GitHub Stars License Bilibili Discord QQ-Gruppe

Projekt-Highlights · Kreativwerkzeuge · Kreativvorlagen · Skills · Unterhaltung & Arbeitsbereich · Unterstützte Modelle · Beispiele · Schnellstart · Desktop · Systemstruktur · Entwicklung · Dokumentation · Mitwirken · Mitwirkende · Star-Verlauf

OpenCreator Agent-Arbeitsbereich

Projektüberblick

OpenCreator richtet sich an Einzelpersonen und Teams, die kreative Arbeit und Entwicklung lokal ausführen möchten. Anstatt eine eigene Agent-Schleife neu zu implementieren, nutzt OpenCreator Codex CLI als Ausführungs-Engine und ergänzt sie um eine stabile lokale Runtime, einen visuellen Arbeitsbereich und einen Desktop-Host.

OpenCreator bietet zwei miteinander verbundene Arbeitsweisen:

  • Content-Workspace: Nutze visuelle Werkzeuge und Kreativvorlagen für Videoübersetzung, Video-Downloads, Thumbnail-Generierung, Bildgenerierung und weitere kreative Aufgaben.
  • Agent-Unterhaltung: Starte und steuere kreative oder Entwicklungsaufgaben in natürlicher Sprache, organisiere Unterhaltungen nach Projekten, lasse Runs im Hintergrund weiterarbeiten und verwalte Genehmigungen, Anhänge, Dateien, Skills, MCP, Zeitpläne, Benachrichtigungen, Speicher und Diagnosen an einem Ort.

Web ist die einzige Frontend-Implementierung. Desktop lädt denselben Web-Build und ergänzt ausschließlich Funktionen, die das Betriebssystem erfordern, etwa die Auswahl von Verzeichnissen, den Fensterlebenszyklus, das Verhalten im Infobereich und native Benachrichtigungen. Bei identischen Daten und derselben Größe des Inhaltsbereichs teilen beide Plattformen dieselbe allgemeine Benutzeroberfläche und dasselbe Runtime-Verhalten.

Projekt-Highlights

  • 🤖 Codex-nativ: Nutze die Agent-Schleife, Modelle, Schlussfolgerungen, Werkzeugaufrufe, Unterhaltungen, Skills und MCP von Codex, ohne eine zweite Ausführungs-Engine pflegen zu müssen.

  • 🚀 Sofort einsatzbereite Desktop-App: Starte OpenCreator direkt über die Desktop-App mit integriertem Codex CLI. Der lokale Runtime startet bei Bedarf und bereitet automatisch ein Standardprojekt vor.

  • 🔄 Verwaltete Runtime-Komponenten: Prüfe die mitgelieferte, aktive und neueste yt-dlp-Version, suche regelmäßig nach Updates und aktualisiere manuell. Falls ein Update fehlschlägt, bleibt die aktuell funktionierende Version verfügbar.

  • 🎨 Multimodale Erstellung: Erstelle und verwalte Videos, Bilder, Audio, Untertitel und Dokumente in einem zusammenhängenden Arbeitsablauf.

  • 🧩 Kreativvorlagen: Erstelle Bilder und Videos mit wiederverwendbaren Vorlagen, statt Prompts und Einstellungen von Grund auf vorzubereiten.

  • 🔗 Arbeitsablauf mit zwei Modi: Arbeite wahlweise im visuellen Arbeitsbereich oder über eine Agent-Unterhaltung, während eine gemeinsame Zustandsmaschine Schritte, Fortschritt und Ergebnisse synchron hält.

  • 🕘 Versionierung: Jede Überarbeitung erstellt eine neue Version und bewahrt frühere Einstellungen und Ergebnisse zur Prüfung und zum Vergleich auf.

  • 🧩 Wiederverwendbare Skills: Nutze Skills für Video-Workflows, erweitere den Agent mit eigenen Skills und verwalte MCP über die Codex-native Konfiguration.

  • 🧠 Speicher: Bewahre globalen, projektbezogenen und Thread-Speicher zusammen mit Zusammenfassungen und reproduzierbaren Run-Eingabe-Snapshots auf.

  • 🔐 Lokale Sicherheit: Daten, Anhänge und Protokolle bleiben standardmäßig lokal und werden durch Genehmigungen und bereinigte Diagnosen geschützt.

Kreativwerkzeuge

Die aktuelle Version enthält sechs Kreativwerkzeuge. Verfügbare Modelle und Dienste hängen von deiner lokalen Codex-Umgebung und den Einstellungen der KI-Dienste ab.

Öffne das Dashboard, um Videos zu übersetzen oder herunterzuladen, Thumbnails oder Bilder zu generieren, Voiceover mit intelligenter Synchronisation zu erstellen oder Videos mit Seedance zu generieren.

OpenCreator Kreativ-Dashboard

Weitere Kreativwerkzeuge werden fortlaufend ergänzt.

Werkzeug Status Funktionen
Videoübersetzung✅ VerfügbarImportiere lokale oder öffentliche Videos; transkribiere sie mit lokalen oder cloudbasierten Whisper-Diensten; nutze den LLM-Kontext für Segmentierung und Ausrichtung von Untertiteln, Terminologie und Übersetzung; konfiguriere zweisprachige Untertitel, Synchronisation oder ein eigenes Sprachbeispiel, Untertitelstile sowie Quer- oder Hochformat und exportiere SRT, Audio oder Video
Video-Downloader✅ VerfügbarAnalysiere unterstützte öffentliche Links von YouTube, Bilibili und anderen Quellen, prüfe verfügbare Qualitäts- und Formatoptionen und lade Video oder Audio für nachfolgende Arbeitsabläufe herunter
Thumbnail-Generierung✅ VerfügbarKombiniere ein Thema, einen Videolink und optional ein Referenzbild, um mehrere Varianten von Content-Thumbnails zu generieren und zu vergleichen
Bildgenerierung✅ VerfügbarGeneriere mit GPT Image Bilder aus einem Prompt und einem optionalen Referenzbild, lege Seitenverhältnis und Anzahl der Ergebnisse fest und zeige einzelne Bilder in der Vorschau an oder lade sie herunter
Strichmännchen-AnimationDemnächstEntwickle Figuren, Storyboards, Voiceover und Animation in einem geführten Arbeitsablauf
Automatische ClipsIn EntwicklungAnalysiere lange Videos, finde Höhepunkte und verwandle ausgewählte Momente in wiederverwendbare kurze Clips
Intelligente Synchronisation✅ VerfügbarVerwandle Skripte in Voiceover und wähle Stimme, Tempo und Emotion
Videogenerierung✅ VerfügbarGeneriere mit Seedance Videos aus Prompts und Referenzbildern und zeige jede Version in der Vorschau an, generiere sie erneut oder lade sie herunter
Digitaler AvatarIn EntwicklungKombiniere Skripte, Stimme und Avatar-Darstellung zu Talking-Head-Videos

Kreativvorlagen

Starte direkt mit einer Vorlage, statt Prompts und Einstellungen von Grund auf anzulegen. Entdecke vorgestellte Vorlagen nach Kategorien wie Videoproduktion und Bildgestaltung.

Die Sammlung vereint Vorlagen von OpenCreator und unabhängigen Kreativen. Bei Vorlagen Dritter nennt die Detailseite die Urheber und verlinkt auf die Originalquelle.

Galerie vorgestellter Kreativvorlagen für Videos und Bilder

Öffne eine Vorlage, um ein Beispielergebnis sowie Prompt, Einstellungen, Tags, Autor und Originalquelle zu sehen. Wähle Diese Vorlage verwenden, um mit der Vorlage loszulegen, und passe die Eingaben nach Bedarf an.

Details einer Bildvorlage mit Beispielergebnis, Einstellungen und Prompt

Skills

Kreativwerkzeuge bieten visuelle Steuerelemente; Skills geben dem Agent wiederverwendbare Anweisungen und Werkzeug-Workflows. OpenCreator enthält Skills für die Videoproduktion im Repository und unterstützt die Verwaltung lokaler Codex Skills.

Das Verzeichnis skills/ im Repository enthält wiederverwendbare Anweisungen für Agents, die die eingebettete KrillinAI CLI bedienen.

Skill Funktionen
KrillinAI CLI Befehle auswählen, Konfiguration prüfen und Fortschritt, Manifeste, Ausgaben und Fehler interpretieren
Untertitel Plattformuntertitel herunterladen oder Medien transkribieren, Untertitel übersetzen und zweisprachige oder kurze Hochformat-Untertitel erstellen
TTS Synchronisation in der Zielsprache aus Untertiteln erzeugen und optional ein synchronisiertes Video erstellen
Querformat-Rendering Querformatvideos mit zweisprachigen Untertiteln oder synchronisiertem Ton und Untertiteln in der Zielsprache rendern
Hochformat-Rendering Hochformatvideos mit Titeln, zweisprachigen Untertiteln oder Synchronisation zusammensetzen
Cover Ein Coverbild aus einem vollständigen Textprompt erzeugen und Bild sowie finalen Prompt speichern
Pipeline-Planung Einen mehrstufigen Ausgabeplan im Dry-Run-Modus prüfen; die eigentliche Arbeit über die Skills der einzelnen Stufen ausführen

Mit eigenen Skills erweitern

OpenCreator unterstützt lokale Codex Skills, die durch SKILL.md definiert werden. So kannst du eigene Methoden und Workflows ergänzen, statt nur feste Kreativwerkzeuge zu nutzen. Verfügbare Skills hängen vom aktiven Codex home und den installierten Skills ab; Video-Workflow-Skills erfordern eine konfigurierte CLI und die jeweiligen Dienste. Ein Skill im Repository ist nicht automatisch installiert, und externe Dienste sind nicht zwangsläufig enthalten.

Unterhaltung und Arbeitsbereich, gemeinsam voran

Beschreibe Aufgaben in natürlicher Sprache und wechsle zu visuellen Werkzeugen, wenn du präzise Kontrolle benötigst.

Die gezeigten Anbieter und Modelle sind Beispiele. Die tatsächliche Verfügbarkeit hängt von Zugangsdaten, Anbieterfreigaben und Plattform ab.

Präzise Steuerung im Arbeitsbereich

Passe Untertitel, Szenen, Audio und Generierungseinstellungen genau an.

Flexible Bearbeitung im Dialog

Teile dem Agent mit, was geändert werden soll, und verfeinere das Ergebnis in natürlicher Sprache.

Synchronisierter Status

Unterhaltung und Arbeitsbereich teilen den aktuellen Aufgabenstatus, sodass du nichts wiederholen musst.

Unabhängige Versionen

Jede Überarbeitung erstellt eine separate Version, ohne frühere Ergebnisse oder Einstellungen zu überschreiben.

Unterstützte Modelle

Die Verfügbarkeit von Sprachmodellen richtet sich nach dem Codex-Modellkatalog oder deinem OpenAI-kompatiblen Anbieter. Bild-, Video-, Sprach- und Transkriptionsmodelle verwenden die unter Einstellungen → KI-Dienste konfigurierten Dienste.

Die Tabellen zeigen integrierte Anbieterprofile und empfohlene Modelle. Die tatsächliche Verfügbarkeit hängt von Zugangsdaten, Anbieterfreigaben und Plattform ab.

Sprachmodelle

OpenAI
GPT
DeepSeek
DeepSeek
Qwen
Qwen
Kimi
Kimi
Z.ai
GLM
xAI
Grok
Doubao
Doubao
ERNIE
ERNIE
Tencent Hunyuan
Hunyuan
MiniMax
MiniMax

Bild

OpenAI
GPT Image
Jimeng
Seedream 4.0
Jimeng
Kling
Kling v2.1
Kling Image
Gemini
Nano Banana
Gemini 2.5 Flash Image

Video

Seedance
Seedance 2.5
Kling
Kling v2.1 Master
Gemini
Veo 3.1

Sprache und Transkription

OpenAI
Whisper
OpenAI
OpenAI TTS
MiniMax
MiniMax
Microsoft
Edge TTS
Alibaba Cloud
Aliyun Speech

Für lokale Transkription stehen auf unterstützten Plattformen auch faster-whisper, WhisperKit und whisper.cpp bereit.

Beispiele

Videoübersetzung

Die folgenden öffentlichen Beispiele entstanden, als OpenCreator noch KrillinAI hieß. Sie zeigen den bewährten Arbeitsablauf für Untertitelausrichtung, Übersetzung, Synchronisation und Hochformatvideos, den der Arbeitsbereich Videoübersetzung von OpenCreator in einen umfassenderen Agent-Arbeitsablauf integriert.

Das Projekt erzeugte die unten gezeigte Untertiteldatei in einem einzigen Durchlauf aus einem 46-minütigen lokalen Video, ohne manuelle Anpassung der Untertitel. Das veröffentlichte Ergebnis deckt das Video vollständig ab, enthält keine überlappenden Zeilen und bietet eine natürliche Segmentierung sowie eine hochwertige Übersetzung.

Beispiel für OpenCreator Untertitelausrichtung

Untertitelübersetzung

https://github.com/user-attachments/assets/bba1ac0a-fe6b-4947-b58d-ba99306d0339

Synchronisation

https://github.com/user-attachments/assets/0b32fad3-c3ad-4b6a-abf0-0865f0dd2385

Hochformat

https://github.com/user-attachments/assets/c2c7b528-0ef8-4ba9-b8ac-f9f92f6d4e71

Diese Videobeispiele und das Bild zur Untertitelausrichtung entstanden, als OpenCreator noch den Namen KrillinAI verwendete.

Videogenerierung

Erstelle mit Seedance ein KI-Video aus einem Text-Prompt oder Referenzbild. Konfiguriere Modell, Seitenverhältnis, Auflösung und Dauer. Anschließend kannst du jede Version im Projektarbeitsbereich ansehen, neu generieren oder herunterladen.

OpenCreator Videogenerierung mit Seedance

Video-Download

Analysiere einen öffentlichen Videolink, vergleiche die verfügbaren Formate und lade Video oder Audio direkt in das Projekt herunter.

Formatauswahl im OpenCreator Video-Downloader

Strichmännchen-Animation (demnächst)

Demnächst verfügbar. In der aktuellen Version noch nicht integriert.

OpenCreator hat diese Sammlung eigener Figuren gemeinsam mit dem Künstler Harbor Hsia, dem Schöpfer von Stickman auf Behance, entwickelt. Die vordefinierten Figuren werden für einen künftigen Story- und Animationsablauf mit konsistenten Charakteridentitäten vorbereitet.

Gemeinsam mit Künstlern entwickelte OpenCreator Strichmännchen

Der geplante Arbeitsablauf führt eine Figuren- und Storyidee durch Storyboard-Generierung, Szenenprüfung, Voice-over, Musik und versionierte Animationsausgabe.

Beispielbild einer OpenCreator Strichmännchen-Animation

Schnellstart

Voraussetzungen

  • Node.js 22 oder neuer
  • pnpm 9.15.0, festgelegt über das Feld packageManager des Repositorys
  • Eine im Terminal verfügbare ausführbare Codex CLI
  • Eine gültige Codex CLI-Anmeldung für echte Modellaufgaben

Prüfe zuerst deine lokale Umgebung:

node --version
pnpm --version
codex --version

Web aus dem Quellcode ausführen

git clone https://github.com/krillinai/OpenCreator.git
cd OpenCreator
corepack enable
pnpm install
pnpm web:dev

Öffne http://127.0.0.1:19861/. Der Entwicklungsserver startet den lokalen Daemon bei Bedarf und injiziert über einen Same-Origin-Proxy ein temporäres Runtime-Token, sodass kein Verbindungstoken manuell kopiert werden muss.

Beim ersten Start bereitet die Runtime ein Standardprojekt vor. Das Eingabefeld ist verfügbar, sobald die Verbindung hergestellt ist. So arbeitest du ausschließlich am Daemon:

pnpm daemon:dev

Der Daemon lauscht nur auf einer Loopback-Adresse und gibt seine Verbindungsadresse sowie das temporäre Token einmalig auf stdout aus.

Desktop

Desktop und Browser verwenden dasselbe React-Frontend aus apps/web. Allgemeines Verhalten für Projekte, Unterhaltungen, Aufgaben und Einstellungen ruft dieselben Daemon/API auf. Electron ergänzt lediglich echte Systempfade, Fenstersteuerung, Verhalten im Infobereich und native Benachrichtigungen.

Entwicklungsmodus

pnpm desktop:dev

Lokale Paketierung

Befehl Ausgabe
pnpm desktop:package Ein ausführbares Verzeichnis für die aktuelle Plattform zur lokalen Überprüfung
pnpm desktop:dist Ein Installationsprogramm für die aktuelle Plattform
pnpm desktop:release Der Paketierungs-Einstiegspunkt für eine offizielle Veröffentlichung
pnpm --filter @opencreator/desktop verify:package Überprüfung eines vorhandenen Desktop-Pakets

Die Desktop-Paketierung baut Web aus dem aktuellen Arbeitsbereich neu, zeichnet Commit, Dirty-Status, Plattform, Architektur und Web-Hash auf und vergleicht apps/web/dist mit den in die Anwendung eingebetteten Ressourcen. Bei Abweichungen schlägt die Paketierung fehl. Einzelheiten zu Signierung, Notarisierung, Windows-Builds und Veröffentlichungsanforderungen findest du im Desktop-Release-Runbook.

Zentrale Arbeitsabläufe

Unterhaltungen und Runs

  1. Wähle ein Projekt aus oder starte eine neue Unterhaltung.
  2. Gib eine Aufgabe ein und wähle Berechtigungsstufe, Profile, Modell und Denkaufwand.
  3. Während ein Run aktiv ist, kannst du Folgeaufgaben einreihen oder ihn unterbrechen und sofort fortfahren.
  4. Prüfe in der Timeline Zusammenfassungen der Schlussfolgerungen, Werkzeugaufrufe, Dateiänderungen, Genehmigungen und Endergebnisse.
  5. Verfolge im Aufgabencenter laufende, abgeschlossene, fehlgeschlagene und durch Genehmigungen blockierte Aufgaben zentral.

Skills und MCP

  • Durchsuche im Plugin-Center den Skill-Marktplatz, den Installationsverlauf und lokal verfügbare Skills.
  • Wähle im Eingabefeld mit / oder über das Hinzufügen-Menü einen Skill, damit die nächste Aufgabe dessen Arbeitsablauf befolgt.
  • Die MCP-Verwaltung verwendet Codex-native Befehle und Konfigurationen, anstatt eine zweite Ausführungs-Engine zu pflegen.
  • OpenCreator verwendet standardmäßig das aktive $CODEX_HOME. Prüfe daher die Auswirkungen, bevor du globale Skills oder die MCP-Konfiguration änderst.

Zeitpläne und dedizierte Aufgaben-Threads

  • Jeder Zeitplan besitzt eine dauerhafte, dedizierte OpenCreator-Unterhaltung.
  • Automatische Auslöser, manuelle Ausführungen und Folgeaufgaben des Benutzers verwenden diese Unterhaltung erneut und laufen gemäß der Richtlinie queue oder skip nacheinander ab.
  • Beim Löschen eines Zeitplans wird dessen dedizierte Unterhaltung archiviert, während vorhandene Runs, Ergebnisse und der zugrunde liegende Codex-Verlauf erhalten bleiben.
  • Das Rotieren oder Wiederherstellen eines zugrunde liegenden Codex-Threads ändert weder den OpenCreator-Aufgabeneintrag noch die Seitenroute.

OpenCreator-Systemstruktur

OpenCreator behandelt den visuellen Arbeitsbereich und die Agent-Unterhaltung als zwei Oberflächen für dieselbe kreative Aufgabe und nicht als getrennte Arbeitsabläufe. Jeder Kreativablauf wird als Zustandsmaschine modelliert: Quelleingabe, Konfiguration, Generierung, Prüfung, Überarbeitung und Export werden zu eindeutigen Zuständen und Ereignissen. Aktionen im Arbeitsbereich und Befehle in Unterhaltungen gelangen in dieselbe Zustandsmaschine. Der aktuelle Schritt, die Konfiguration, der Fortschritt, die Versionen und die Ergebnisse werden wiederum in beiden Oberflächen dargestellt. So bleiben Arbeitsbereich und Unterhaltung synchron, ohne eine zweite Informationsquelle einzuführen.

Kreative Arbeit ist iterativ, daher überschreiben Überarbeitungen das aktuelle Ergebnis nicht. Jede Korrektur oder Neugenerierung erstellt aus dem bestehenden Zustand des Arbeitsablaufs eine neue Version. Einstellungen und Ergebnisse früherer Versionen bleiben zur Prüfung, zum Vergleich und zur weiteren Bearbeitung erhalten.

+-----------------------------+     +------------------------------------+
| Browser Access              |     | Desktop Host                       |
|                             |     | Shared Web build + Electron        |
+--------------+--------------+     +------------------+-----------------+
               |                                       |
               +-------------------+-------------------+
                                   v
+----------------------------------------------------------------------------+
| Creator Experience / apps/web                                              |
| Dashboard / Creator Tools / Agent Conversation / Settings / Files          |
+-------------------------------------+--------------------------------------+
                                      |
+-------------------------------------v--------------------------------------+
| Collaboration Core                                                         |
| Shared workflow state / Steps / Progress / Results / Versions              |
+-------------------------------------+--------------------------------------+
                                      | Runtime API + SSE
+-------------------------------------v--------------------------------------+
| Local Runtime / apps/daemon                                                 |
| Projects / Runs / Approvals / Schedules / Memory / Notifications           |
| Component status / Update checks / Verified updates / Safe fallback        |
+-------------+------------------------+------------------------+-------------+
              |                        |                        |
              v                        v                        v
+---------------------+  +---------------------+  +-------------------------+
| Local Data          |  | Codex Engine        |  | Media Toolchain         |
| SQLite / Files      |  | CLI / app-server    |  | FFmpeg / yt-dlp         |
| System credentials  |  | Skills / MCP        |  | Whisper / AI services   |
+---------------------+  +---------------------+  +-------------------------+
OpenCreator-Komponente Aufgabe Implementierung
Kreativerlebnis Dashboard, Kreativwerkzeuge, Agent-Unterhaltung, Einstellungen und Dateien apps/web · React 18 · Vite · TypeScript
Kollaborationskern Synchronisiert Arbeitsschritte, Unterhaltungskontext, Fortschritt, Ergebnisse und Überarbeitungen Gemeinsamer Workflow-Status · CreatorCollaborationPanel · Versionsverlauf
Lokaler Runtime Verwaltet Projekte, Runs, Genehmigungen, Zeitpläne, Speicher und Benachrichtigungen apps/daemon · Fastify · Runtime API · SSE
Runtime-Komponenten Verfolgt mitgelieferte, aktive und neueste Versionen, prüft regelmäßig und installiert nur angeforderte Updates yt-dlp nightly · Update-Prüfung · Rückgriff auf funktionierende Version
Codex-Engine Stellt Agent-Schleife, Sitzungen, Schlussfolgerungen, Werkzeuge, Skills und MCP bereit Codex CLI · app-server
Medienwerkzeuge Lädt kreative Medien herunter, transkribiert, transformiert, generiert und exportiert sie yt-dlp · Whisper · FFmpeg · konfigurierte KI-Dienste
Lokale Daten Speichert Projektdaten, Runs, Anhänge, Ausgaben und Zugangsdaten lokal SQLite · Dateisystem · System-Zugangsdatenverwaltung
Desktop-Host Lädt den gemeinsamen Web-Build und ergänzt Betriebssystemfunktionen apps/desktop · Electron · Preload Bridge

Grundprinzipien:

  • Arbeitsbereich und Agent-Unterhaltung sind synchronisierte Ansichten desselben Arbeitsablaufzustands. Beide senden Ereignisse an dieselbe Zustandsmaschine, anstatt parallele Aufgabenzustände zu pflegen.
  • Überarbeitungen erstellen neue Versionen, statt vorhandene Ergebnisse zu ersetzen. Kontext und Ausgabe jeder kreativen Iteration bleiben erhalten.
  • Das Frontend startet Codex nicht direkt und hängt nicht von Codex' unbearbeitetem JSONL-Ereignisformat ab.
  • Der Daemon verwaltet Prozesslebenszyklus, Ereignisnormalisierung, Persistenz, Genehmigungen, Zeitpläne und die Benachrichtigungs-Outbox.
  • Codex bleibt die maßgebliche Ausführungsquelle für Agent-Schleife, Skills und MCP.
  • Browser Bridge und Desktop Bridge implementieren keine getrennten Kopien der allgemeinen Produktlogik.

Repository-Struktur

OpenCreator/
├── apps/
│   ├── web/          # Die einzige React-Frontend-Implementierung
│   ├── daemon/       # Lokaler Fastify Runtime und Codex-Adapter
│   ├── desktop/      # Electron Main, Preload, native Funktionen und Paketierung
│   └── harness/      # Kommandozeilenwerkzeug zur Runtime-Überprüfung
├── packages/
│   ├── protocol/     # Von Web, Daemon und Desktop gemeinsam genutzte Runtime-Verträge
│   └── skill-market/ # Modelle des Skill-Marktplatzes und gemeinsame Logik
├── docs/             # Designdokumente, API-Referenzen, Runbooks und Testberichte
├── scripts/          # Repository-weite Prüfungen
└── .runtime/         # Lokale Runtime-Daten, beim ersten Start erstellt

Konfiguration

API-Schlüssel für KI-Dienste

Öffne Einstellungen → KI-Dienste, um die Modell-, Transkriptions-, Audio- und Bildanbieter der aktuellen Arbeitsbereiche zu konfigurieren. Zur Vorbereitung auf kommende Kreativwerkzeuge können zusätzliche Dienstkategorien erscheinen. Jede Kategorie zeigt nur die für den ausgewählten Anbieter erforderlichen Felder an, darunter Base URL, API Key, Modell, Proxy oder anbieterspezifische Zugangsdaten.

OpenCreator Einstellungen für API-Schlüssel von KI-Diensten

Zugangsdaten werden über den System-Zugangsspeicher der lokalen Runtime gespeichert und dürfen niemals in das Repository committet werden. Einige lokale oder systemgestützte Anbieter wie Edge TTS benötigen keinen API Key.

Runtime-Komponenten von Drittanbietern

Öffne Einstellungen → Drittanbieter-Komponenten, um die derzeit verwendete yt-dlp-nightly-Version, die mit OpenCreator gelieferte Version, ihre Quelle und die neueste verfügbare Version zu prüfen. OpenCreator sucht alle sieben Tage nach Updates, installiert sie jedoch nie automatisch. Updates erfordern eine ausdrückliche Benutzeraktion. Falls Download, Prüfung oder Installation fehlschlagen, bleibt die aktuell funktionierende Version verfügbar.

Einstellungen für OpenCreator-Drittanbieter-Komponenten

Runtime-Umgebungsvariablen

Die meisten Benutzer benötigen keine Umgebungsvariablen. Verwende sie, wenn du isolierte Daten, eine bestimmte Codex-Programmdatei oder ein benutzerdefiniertes Verzeichnis für verwaltete Projekte benötigst:

Umgebungsvariable Standardwert Zweck
OPENCREATOR_DATA_DIR .runtime OpenCreator-Datenbank, Runs, Anhänge und verwaltete Arbeitsbereiche
OPENCREATOR_CODEX_BIN codex Pfad zur ausführbaren Codex CLI
CODEX_HOME ~/.codex Maßgebliche Quelle für Codex-Sitzungen, Konfiguration, Skills, MCP und Profiles
OPENCREATOR_DEFAULT_CWD Aktuelles Arbeitsverzeichnis Standardarbeitsverzeichnis des Daemons
OPENCREATOR_DEFAULT_PROJECT_ROOT Runtime-Standardrichtlinie Stammverzeichnis verwalteter Projekte; wenn festgelegt, verwendet OpenCreator dessen Unterverzeichnis OpenCreator/
OPENCREATOR_CODEX_THREAD_ROTATION_RUN_THRESHOLD 50 Schwellenwert beendeter Runs zum Rotieren des Codex-Threads hinter einem lang laufenden Zeitplan; mit 0 wird die proaktive Rotation deaktiviert

So isolierst du beispielsweise sowohl Runtime-Daten als auch die Codex-Umgebung:

OPENCREATOR_DATA_DIR=/path/to/opencreator-data \
CODEX_HOME=/path/to/codex-home \
pnpm web:dev

Daten und Sicherheit

Runtime-Daten werden standardmäßig unter .runtime/ im Stammverzeichnis des Repositorys gespeichert:

Pfad Inhalt
.runtime/app.sqlite Projekte, Threads, Runs, Ereignisse, Zeitpläne, Benachrichtigungen, Metadaten von Anhängen, Genehmigungen, Speicher und Zusammenfassungen
.runtime/runs/ Bereinigte Protokolle, Diagnosen und Metadaten einzelner Runs
.runtime/attachments/ Kontrollierte Anhangsdateien
.runtime/workspaces/ Vom Runtime verwaltete Projektarbeitsbereiche

Codex-Sitzungen und -Konfiguration verbleiben in $CODEX_HOME und müssen getrennt von .runtime/ gesichert werden.

Zu den Sicherheitsgrenzen gehören:

  • Der Daemon lauscht ausschließlich auf 127.0.0.1; jede API mit Ausnahme der Zustandsprüfung erfordert ein Bearer-Token.
  • Die HTML-Vorschau deaktiviert standardmäßig Skripte, Navigation und Pop-ups und erlaubt nur kontrollierte relative Ressourcen aus demselben Arbeitsbereich.
  • Sensibler Speicher erfordert eine zweite Bestätigung. OpenCreator speichert unbestätigte Vorschläge niemals automatisch und dauerhaft.
  • Diagnosen und Run-Protokolle werden vor der Rückgabe oder dem Export bereinigt.
  • Desktop-Pakete aktivieren ASAR-Integrität und Cookie-Verschlüsselung und deaktivieren RunAsNode, NODE_OPTIONS und den Node CLI Inspector.

Vollständige Anleitungen zu Sicherung, Wiederherstellung, Bereinigung und Zurücksetzen findest du im Benutzerhandbuch und Leitfaden zur Fehlerbehebung.

Entwicklung

Häufige Befehle

Befehl Zweck
pnpm web:dev Web starten und den lokalen Daemon bei Bedarf ausführen
pnpm daemon:dev Nur den Daemon starten
pnpm desktop:dev Abhängigkeiten bauen und Electron im Entwicklungsmodus starten
pnpm test Unit- und Integrationstests des Arbeitsbereichs ausführen
pnpm typecheck TypeScript-Prüfungen im gesamten Repository ausführen
pnpm build Alle Workspaces bauen
pnpm e2e Playwright-E2E-Tests für Web ausführen
pnpm smoke:ci Runtime-Smoke-Test mit einem simulierten Codex ausführen
pnpm perf:check Aufgezeichneten Leistungsreferenzwert prüfen

Führe vor dem Einreichen einer Änderung mindestens Folgendes aus:

pnpm test
pnpm typecheck
pnpm build

Änderungen an Desktop, Host Bridge, Runtime-Proxy oder gemeinsam genutzten Frontend-Arbeitsabläufen erfordern außerdem Web/Desktop-Konsistenztests, E2E-Tests der paketierten Anwendung und eine Überprüfung des Web-Build-Hashs. Das Bestehen der Web-Unit-Tests allein belegt nicht, dass Desktop veröffentlichungsbereit ist.

Der Smoke-Test mit echtem Codex ist standardmäßig deaktiviert. Aktiviere ihn ausdrücklich mit:

OPENCREATOR_RUN_REAL_CODEX_SMOKE=1 \
pnpm --filter @opencreator/daemon test -- test/smoke/real-codex-smoke.test.ts

Dokumentation

Übersetzungskonvention

Die Datei README.md im Stammverzeichnis ist das maßgebliche englische Dokument. Gepflegte Übersetzungen befinden sich unter docs/<locale>/README.md. Füge eine Sprache erst dann zur Sprachauswahl hinzu, wenn das vollständige Dokument übersetzt und mit der englischen Struktur synchronisiert wurde.

Mitwirken

Du kannst auf viele Arten zu OpenCreator beitragen, nicht nur mit Code:

Art Beitrag Vorbereitung Wo einreichen
Code Fehlerbehebung, Kreativabläufe, gemeinsame Funktionen Gezielte Änderung, Demo oder Reproduktion, Tests IssuePR; apps/web/ oder apps/daemon/
Skills Wiederverwendbare Agent-Workflows SKILL.md, Voraussetzungen und Beispiele IssuePR in skills/
Kreativvorlagen Wiederverwendbare Bild-, Video- oder Covervorlagen template.json, Cover- und Beispielmedien, Prompts, Einstellungen, Quellenangabe und Nutzungsrechte PR in template/; neue Formate im Issue besprechen
Illustration und Design Eigene Illustrationen, Icons oder UI Vorschau, bearbeitbare Quelldateien und Lizenz IssuePR am vereinbarten Asset-Ort
Drittanbieter-Integrationen KI- oder Mediendienste Anwendungsfall, Konfiguration, Fehler, Schutz der Zugangsdaten und Tests IssuePR in Web- / Daemon-Modulen

Lege jede Vorlage mit ihren Medien unter template/<module>/<id>/<version>/template.json ab. Die aktuellen Module sind image-generation, video-generation und cover-generator. Titel und Beschreibung müssen auf Chinesisch und Englisch vorliegen. Führe vor dem PR pnpm templates:validate aus.

So trägst du bei:

  1. Beschreibe Problem, Anwendungsfall und erwartetes Verhalten in den Issues.
  2. Erstelle vom neuesten Entwicklungsbranch einen fokussierten Feature- oder Fix-Branch.
  3. Folge der bestehenden Architektur: Implementiere allgemeine Produktfunktionen einmal in Web und Daemon und isoliere native Unterschiede hinter ausdrücklichen Capabilities.
  4. Ergänze angemessene Unit-, Integrations- oder E2E-Abdeckung für Verhaltensänderungen und führe im Pull Request sowohl abgeschlossene als auch ausgelassene Prüfungen auf.
  5. Committe niemals .runtime/, lokale Zugangsdaten, Codex-Sitzungen, Build-Caches oder andere Benutzerdaten.

Mitwirkende

Vielen Dank an alle, die mit Code, Dokumentation, Feedback, Fehlerberichten, Skills, Designs und Ideen beigetragen haben.

OpenCreator Mitwirkende

Star-Verlauf

OpenCreator hieß früher KrillinAI. Dieses Diagramm zeigt den vollständigen Verlauf des Repositorys vor und nach der Umbenennung.

OpenCreator Star-Verlauf

Verwandte Projekte

Projekt Aufgabe
OpenAI Codex Agent-Ausführungs-Engine für Modellzugriff, Schlussfolgerungen, Werkzeugaufrufe, Sitzungen, Skills und MCP-Integration.
yt-dlp Prüft unterstützte öffentliche Medienlinks, listet verfügbare Formate auf und lädt Video oder Audio für Kreativabläufe herunter.
FFmpeg FFmpeg und ffprobe übernehmen Medienkonvertierung, Komposition, Frame-Extraktion und Ausgabeprüfung.
Whisper, whisper.cpp, faster-whisper und WhisperKit Cloud- und plattformspezifische lokale Sprachtranskriptionsoptionen, ausgewählt nach den verfügbaren Runtime-Funktionen.
React Grundlage der gemeinsamen Benutzeroberfläche für Web und Desktop.
Fastify HTTP- und API-Grundlage des lokalen Runtime.
Electron Desktop-Host für native Systemfunktionen, Anwendungslebenszyklus und Paketierung.
SQLite Lokale Speicherung für Projekte, Unterhaltungen, Runs, Zeitpläne, Speicher und weitere Arbeitsbereichsdaten.
Model Context Protocol Offenes Protokoll zum Verbinden externer Werkzeuge und Dienste mit dem Agent-Arbeitsbereich.

OpenCreator · Lokal erstellen, kontinuierlich arbeiten.