Configuration de l'espace de travail
Fonctionne sur macOS (Apple Silicon), Linux avec apt (Ubuntu 22.04+, Debian 12+) et Windows via WSL 2. Ce dépôt contient les règles, compétences, outils, sons CC0 partagés, Previs Studio et un film de démonstration, mais rien lié à une machine ou à une personne : pas de clés API, pas de .venv, pas de node_modules, pas de compétences ou plugins utilisateur, pas de OWNER.md. Cette compétence met le propriétaire en état de travailler dans son studio. SETUP.md est la même procédure écrite pour les humains.
Parlez au propriétaire en termes simples. Il n'est peut-être pas technique, et il ne connaît peut-être rien au motion design. Une étape à la fois, dites ce que fait chaque étape, pourquoi, et combien de temps elle prend.
Règles strictes
- Ne demandez jamais une clé API dans le chat, et ne tapez, affichez, enregistrez ou écrivez jamais une clé. Les clés sont entrées via
scripts/setup/keys.sh, que le propriétaire exécute dans son propre terminal avec saisie masquée (Trousseau macOS ; sur Linux/WSL 2, le coffre-fort secret ou~/.config/motion-studio/keys.env). S'ils collent une clé dans le chat malgré tout : ne l'utilisez pas et ne la stockez pas. Dites-leur qu'elle est maintenant dans l'historique du chat, demandez-leur de supprimer cette clé sur le site du fournisseur et d'en créer une nouvelle, puis stockez la nouvelle aveckeys.sh. - Les installations doivent être approuvées par eux (AGENTS.md « Demander d'abord »). Demandez avec AskUserQuestion avant d'exécuter une étape
install.sh, et indiquez la taille du téléchargement. - N'exécutez jamais
sudovous-même. Sur macOS, l'installateur de Homebrew a besoin de leur mot de passe ; sur Linux/WSL 2,bash scripts/setup/install.sh system(apt) en a besoin. Ils exécutent cette unique commande dans leur propre terminal. (Dans une session cloud Claude Code, vous êtes root, vous pouvez donc l'exécuter.)
Étapes
- Pas encore dans le dépôt ? Si le dossier actuel n'est pas une copie de motion-studio (pas de
AGENTS.mdavec « motion-studio » et pas descripts/setup/), clonez-le d'abord :git clone https://github.com/jayfirke/motion-studio.git motion-studio(demandez où, par défaut : un dossiermotion-studiodans leur dossier personnel ou actuel), puis travaillez à l'intérieur. Dites-leur qu'à la fin, ils ouvrent une nouvelle session dans ce dossier. - Dites bonjour et définissez les attentes en 3 lignes : ce que fait la configuration (vérifier les outils, installer ceux qui manquent, écrire leurs préférences, stocker leurs clés), environ 15 à 30 minutes, environ 3 Go de téléchargements (paquets système, Chromium, le modèle Whisper de 1,6 Go). Dites quel système a été détecté (macOS, Linux ou WSL 2).
- Vérification : exécutez
bash scripts/setup/doctor.sh. Résumez les lignes NEED en termes simples (à quoi chacune sert), puis les lignes OPT en une phrase. - Outils système.
- macOS sans Homebrew : demandez-leur d'exécuter l'installateur officiel depuis https://brew.sh dans le Terminal eux-mêmes (il demande leur mot de passe), puis suivez les lignes « Prochaines étapes » qu'il affiche.
- Linux / WSL 2 : demandez-leur d'exécuter
bash scripts/setup/install.sh systemdans leur propre terminal (apt a besoin de leur mot de passe ; il construit aussiwhisper-cliet installe Node 22 et uv). Sur Linux ARM, il affiche une ligneexport HYPERFRAMES_BROWSER_PATH=…à ajouter à leur profil shell. Attendez « terminé », puis exécutez doctor à nouveau.
- Choisir les installations avec une seule AskUserQuestion (sélection multiple). Proposez uniquement ce que doctor a marqué comme manquant :
- « Studio de base » =
install.sh coresur macOS (outils Homebrew, environnement Python virtuel, compétences Claude, plugins Claude) ; sur Linux/WSL 2, après leur étapesystem,install.sh venv skills plugins. Recommandé. - « Modèle Whisper, 1,6 Go » =
install.sh whisper-model(synchronisation temporelle des mots pour les sous-titres et vérifications vocales). Recommandé. - « Paquets Previs Studio » =
install.sh app(pour reconstruire Previs Studio et exécuter ses vérifications). - « onetake » =
install.sh onetake: expériences personnelles non commerciales uniquement (PolyForm Noncommercial). - « Motion Reel Kit » =
install.sh motion-reel <dossier du kit>: seulement s'ils ont acheté ou téléchargé le kit auprès de son créateur (voirCREDITS.md) ; il n'est pas dans ce dépôt. Exécutez les étapes approuvées depuis la racine de l'espace de travail. Les étapes longues (brew, whisper-model) se déroulent en arrière-plan ; dites-leur ce qui s'exécute. Si une étape afficheFAIL …avec le correctif : essayez le correctif une fois, puis expliquez et demandez.
- « Studio de base » =
- Leurs préférences. Copiez
OWNER.example.mdversOWNER.md, puis posez ses questions en un ou deux tours de AskUserQuestion (nom, ce qu'ils créent, utilisation personnelle ou commerciale, expérience en motion design, voix par défaut, niveau de qualité, budget et approbations). Écrivez les réponses dansOWNER.mddans leurs mots. Ce fichier est ignoré par git et jamais partagé. - Clés API. Demandez avec AskUserQuestion lesquelles ils veulent maintenant :
- Fish Audio (nécessaire pour chaque voix off ; compte gratuit ; le modèle gratuit
s2.1-pro-freeest gratuit jusqu'au 30/11/2026) : clé sur https://fish.audio/app/api-keys/. - Freesound (facultatif ; uniquement pour rechercher et télécharger de nouveaux effets sonores ; compte gratuit) : demandez sur https://freesound.org/apiv2/apply/ et copiez « Client secret/Api key » et « Client id ».
Ensuite, demandez-leur d'exécuter
bash scripts/setup/keys.shdans leur propre terminal : - Dans l'application de bureau Claude, si vous avez un outil de terminal (
run_in_terminal), démarrezcd "<workspace>" && bash scripts/setup/keys.shdans leur panneau Terminal et dites-leur de taper dedans. Ne lisez pas le panneau pendant qu'ils tapent. - Sinon, demandez-leur d'ouvrir un terminal (Terminal sur macOS, leur terminal Linux ou WSL) et de coller :
cd <workspace> && bash scripts/setup/keys.sh. Quand ils disent que c'est fait, exécutezbash scripts/setup/doctor.sh --online. Cela confirme que les clés fonctionnent sans les afficher.
- Fish Audio (nécessaire pour chaque voix off ; compte gratuit ; le modèle gratuit
- Extras facultatifs (une courte liste, ils choisissent) :
- Diffusion Studio (montage de séquences réelles, masques d'objets) : sur macOS, ils téléchargent l'application depuis https://diffusion.studio, l'ouvrent une fois, puis vous exécutez
install.sh diffusion-mcp. Sur Linux, il fonctionne comme une application web (https://app.diffusion.studio) sans le MCP. - Le connecteur Fish Audio dans claude.ai (Paramètres → Connecteurs). Pas nécessaire ; les scripts utilisent la clé.
- Remotion est gratuit pour les particuliers et les entreprises de jusqu'à 3 personnes ; les entreprises plus grandes ont besoin d'une licence Remotion.
- Diffusion Studio (montage de séquences réelles, masques d'objets) : sur macOS, ils téléchargent l'application depuis https://diffusion.studio, l'ouvrent une fois, puis vous exécutez
- Terminer. Écrivez
.local/setup.json(créez.local/; il est ignoré par git) :Exécutez{"owner": "<prénom>", "setup_at": "<heure UTC depuis date -u +%Y-%m-%dT%H:%M:%SZ>", "by": "workspace-setup", "doctor": "<la ligne DOCTER>"}bash scripts/setup/session-check.sh(il ne devrait rien afficher maintenant) et doctor une fois de plus. Rapportez ce qui est prêt et ce qui a été ignoré. - Dites-leur la suite :
- Démarrez une nouvelle session Claude Code dans ce dossier. Les compétences, plugins et le MCP Diffusion ne se chargent qu'au démarrage de la session.
- Ouvrez la démo :
python3 -m http.server 8790 --directory _shared/previs/studio, puis http://localhost:8790 (Previs Studio avec le film de démonstration Crumb). - Une première invite à essayer : « Fais une bande-annonce de lancement de 15 secondes pour . Previs d'abord. »
Réexécution
bash scripts/setup/doctor.sh à tout moment. bash scripts/setup/install.sh <étape> répète une étape en toute sécurité. Supprimez .local/setup.json pour exécuter toute cette configuration à nouveau.