Arbeitsbereich einrichten
Läuft auf macOS (Apple Silicon), Linux mit apt (Ubuntu 22.04+, Debian 12+) und Windows über WSL 2. Dieses Repo enthält die Regeln, Fähigkeiten, Werkzeuge, gemeinsam genutzte CC0-Sounds, Previs Studio und einen Demofilm, aber nichts, das an einen Rechner oder eine Person gebunden ist: keine API-Schlüssel, kein .venv, keine node_modules, keine benutzerspezifischen Fähigkeiten oder Plugins, keine OWNER.md. Diese Fähigkeit bringt den Besitzer zu einem funktionierenden Studio. SETUP.md ist das gleiche Verfahren, geschrieben für Menschen.
Sprich mit dem Besitzer in einfachen Worten. Er ist möglicherweise nicht technisch versiert und weiß möglicherweise nichts über Motion Design. Schritt für Schritt, sag, was es tut, warum und wie lange es dauert.
Harte Regeln
- Nie nach einem API-Schlüssel im Chat fragen und nie einen Schlüssel tippen, ausgeben, protokollieren oder schreiben. Schlüssel werden über
scripts/setup/keys.sheingegeben, das der Besitzer in seinem eigenen Terminal mit versteckter Eingabe ausführt (macOS Keychain; unter Linux/WSL 2 der Secret Store oder~/.config/motion-studio/keys.env). Wenn jemand doch einen Schlüssel in den Chat einfügt: verwende oder speichere ihn nicht. Sag ihm, dass der Schlüssel jetzt im Chatverlauf ist, bitte ihn, diesen Schlüssel auf der Website des Anbieters zu löschen und einen neuen zu erstellen und dann den neuen mitkeys.shzu speichern. - Installationen müssen von ihnen genehmigt werden (AGENTS.md „Ask first“). Frage mit AskUserQuestion, bevor du einen
install.sh-Schritt ausführst, und gib die Download-Größe an. - Führe niemals selbst
sudoaus. Unter macOS benötigt das Homebrew-Installationsprogramm ihr Passwort; unter Linux/WSL 2 machtbash scripts/setup/install.sh system(apt) das. Sie führen diesen einen Befehl in ihrem eigenen Terminal aus. (In einer Claude Code Cloud-Sitzung bist du root, du kannst es also ausführen.)
Schritte
- Noch nicht im Repo? Wenn der aktuelle Ordner keine motion-studio-Kopie ist (keine
AGENTS.mdmit „motion-studio“ und keinscripts/setup/), klone es zuerst:git clone https://github.com/jayfirke/motion-studio.git motion-studio(frage wo, Standard: einmotion-studio-Ordner in ihrem Home- oder aktuellen Ordner), dann arbeite darin. Sag ihnen, dass sie am Ende eine neue Sitzung in diesem Ordner öffnen. - Begrüßung und Erwartungen setzen in 3 Zeilen: was die Einrichtung macht (Werkzeuge prüfen, fehlende installieren, ihre Präferenzen schreiben, ihre Schlüssel speichern), ca. 15–30 Minuten, ca. 3 GB Downloads (Systempakete, Chromium, das 1,6 GB Whisper-Modell). Sag, welches System der Doktor gefunden hat (macOS, Linux oder WSL 2).
- Prüfen: führe
bash scripts/setup/doctor.shaus. Fasse die NEED-Zeilen in einfachen Worten zusammen (wofür jede ist), dann die OPT-Zeilen in einem Satz. - Systemwerkzeuge.
- macOS ohne Homebrew: bitte sie, das offizielle Installationsprogramm von https://brew.sh selbst im Terminal auszuführen (es fragt nach ihrem Passwort), dann die „Nächste Schritte“-Zeilen zu befolgen, die es ausgibt.
- Linux / WSL 2: bitte sie,
bash scripts/setup/install.sh systemin ihrem eigenen Terminal auszuführen (apt benötigt ihr Passwort; es baut auchwhisper-cliund installiert Node 22 und uv). Auf ARM Linux gibt es eine Zeileexport HYPERFRAMES_BROWSER_PATH=…aus, die sie zu ihrem Shell-Profil hinzufügen sollen. Warte auf „done“, dann führe doctor erneut aus.
- Installationen auswählen mit einer AskUserQuestion (multiSelect). Biete nur das an, was der Doktor als fehlend markiert hat:
- „Core studio“ =
install.sh coreauf macOS (Homebrew-Tools, Python venv, Claude-Fähigkeiten, Claude-Plugins); auf Linux/WSL 2, nach ihremsystem-Schritt,install.sh venv skills plugins. Empfohlen. - „Whisper model, 1.6 GB“ =
install.sh whisper-model(Wortzeitmarkierungen für Untertitel und Sprachüberprüfungen). Empfohlen. - „Previs Studio packages“ =
install.sh app(um Previs Studio neu zu bauen und seine Prüfungen auszuführen). - „onetake“ =
install.sh onetake: nur persönliche, nicht-kommerzielle Experimente (PolyForm Noncommercial). - „Motion Reel Kit“ =
install.sh motion-reel <kit folder>: nur wenn sie das Kit von seinem Ersteller gekauft oder heruntergeladen haben (sieheCREDITS.md); es ist nicht in diesem Repo. Führe die genehmigten Schritte aus dem Arbeitsbereichsstamm aus. Lange Schritte (brew, whisper-model) laufen im Hintergrund; sag ihnen, was gerade läuft. Ein Schritt gibtFAIL …mit der Behebung aus: versuche die Behebung einmal, dann erkläre und frage.
- „Core studio“ =
- Ihre Präferenzen. Kopiere
OWNER.example.mdnachOWNER.md, frage dann ihre Fragen in einer oder zwei AskUserQuestion-Runden (Name, was sie machen, private oder kommerzielle Nutzung, Motion-Design-Erfahrung, Standardstimme, Qualitätsanspruch, Budget und Genehmigungen). Schreibe die Antworten in ihre eigenen Worte inOWNER.md. Es ist git-ignoriert und wird nie geteilt. - API-Schlüssel. Frage mit AskUserQuestion, welche sie jetzt wollen:
- Fish Audio (wird für jede Sprachausgabe benötigt; kostenloses Konto; das kostenlose Modell
s2.1-pro-freeist bis 2026-11-30 kostenlos): Schlüssel unter https://fish.audio/app/api-keys/. - Freesound (optional; nur um neue Soundeffekte zu suchen und herunterzuladen; kostenloses Konto): beantrage unter https://freesound.org/apiv2/apply/ und kopiere „Client secret/Api key“ und „Client id“.
Dann lass sie
bash scripts/setup/keys.shin ihrem eigenen Terminal ausführen: - In der Claude Desktop-App, wenn du ein Terminal-Werkzeug (
run_in_terminal) hast, startecd "<workspace>" && bash scripts/setup/keys.shin ihrem Terminal-Panel und sag ihnen, sie sollen dort tippen. Lies das Panel nicht, während sie tippen. - Andernfalls bitte sie, ein Terminal zu öffnen (Terminal auf macOS, ihr Linux- oder WSL-Terminal) und einzufügen:
cd <workspace> && bash scripts/setup/keys.sh. Wenn sie sagen, dass es fertig ist, führebash scripts/setup/doctor.sh --onlineaus. Es bestätigt, dass die Schlüssel funktionieren, ohne sie anzuzeigen.
- Fish Audio (wird für jede Sprachausgabe benötigt; kostenloses Konto; das kostenlose Modell
- Optionale Extras (eine kurze Liste, sie wählen):
- Diffusion Studio (echtes Filmmaterial schneiden, Objektmasken): auf macOS laden sie die App von https://diffusion.studio herunter, öffnen sie einmal, dann führst du
install.sh diffusion-mcpaus. Auf Linux läuft es als Web-App (https://app.diffusion.studio) ohne das MCP. - Der Fish Audio-Konnektor in claude.ai (Einstellungen → Konnektoren). Nicht erforderlich; die Skripte verwenden den Schlüssel.
- Remotion ist kostenlos für Einzelpersonen und Unternehmen mit bis zu 3 Personen; größere Unternehmen benötigen eine Remotion-Lizenz.
- Diffusion Studio (echtes Filmmaterial schneiden, Objektmasken): auf macOS laden sie die App von https://diffusion.studio herunter, öffnen sie einmal, dann führst du
- Abschluss. Schreibe
.local/setup.json(erstelle.local/; es ist git-ignoriert):Führe{"owner": "<Vorname>", "setup_at": "<UTC-Zeit von date -u +%Y-%m-%dT%H:%M:%SZ>", "by": "workspace-setup", "doctor": "<die DOCTOR-Zeile>"}bash scripts/setup/session-check.shaus (es sollte jetzt nichts ausgeben) und doctor noch einmal. Berichte, was bereit ist und was übersprungen wurde. - Sag ihnen, was als Nächstes kommt:
- Starte eine neue Claude Code-Sitzung in diesem Ordner. Fähigkeiten, Plugins und das Diffusion MCP werden nur beim Start der Sitzung geladen.
- Öffne die Demo:
python3 -m http.server 8790 --directory _shared/previs/studio, dann http://localhost:8790 (Previs Studio mit dem Crumb-Demofilm). - Ein erster Prompt zum Ausprobieren: „Erstelle ein 15-Sekunden-Launch-Reel für . Zuerst Previs.“
Erneutes Ausführen
bash scripts/setup/doctor.sh jederzeit. bash scripts/setup/install.sh <step> führt einen Schritt sicher wiederholt aus. Lösche .local/setup.json, um die gesamte Einrichtung erneut auszuführen.