Configuração do workspace
Executa no macOS (Apple Silicon), Linux com apt (Ubuntu 22.04+, Debian 12+) e Windows através do WSL 2. Este repositório contém as regras, habilidades, ferramentas, sons CC0 compartilhados, Previs Studio e um filme de demonstração, mas nada vinculado a uma máquina ou pessoa: sem chaves de API, sem .venv, sem node_modules, sem habilidades ou plugins de nível de usuário, sem OWNER.md. Esta habilidade leva o proprietário a um estúdio funcional. SETUP.md é o mesmo procedimento escrito para pessoas.
Converse com o proprietário em palavras simples. Ele pode não ser técnico e pode não saber nada sobre design de movimento. Um passo de cada vez, diga o que faz, por que e quanto tempo leva.
Regras rígidas
- Nunca peça uma chave de API no chat, e nunca digite, ecoe, registre ou escreva uma. As chaves são inseridas através de
scripts/setup/keys.sh, que o proprietário executa em seu próprio terminal com digitação oculta (Keychain do macOS; no Linux/WSL 2, o cofre de segredos ou~/.config/motion-studio/keys.env). Se eles colarem uma chave no chat de qualquer forma: não a use ou armazene. Diga a eles que agora está no histórico do chat, peça para excluir essa chave no site do provedor e criar uma nova, depois armazenar a nova comkeys.sh. - As instalações são para eles aprovarem (AGENTS.md "Pergunte primeiro"). Pergunte com AskUserQuestion antes de executar qualquer etapa do
install.she informe o tamanho do download. - Nunca execute
sudovocê mesmo. No macOS, o instalador do Homebrew precisa da senha deles; no Linux/WSL 2,bash scripts/setup/install.sh system(apt) precisa. Eles executam esse comando em seu próprio terminal. (Em uma sessão cloud do Claude Code você é root, então pode executá-lo.)
Passos
- Ainda não está no repositório? Se a pasta atual não for uma cópia do motion-studio (sem
AGENTS.mdcom "motion-studio" e semscripts/setup/), clone primeiro:git clone https://github.com/jayfirke/motion-studio.git motion-studio(pergunte onde, padrão: uma pastamotion-studiono diretório inicial ou atual), depois trabalhe dentro dela. Diga a eles que no final eles abrem uma nova sessão dentro dessa pasta. - Diga olá e defina expectativas em 3 linhas: o que a configuração faz (verificar ferramentas, instalar as que faltam, escrever suas preferências, armazenar suas chaves), cerca de 15–30 minutos, cerca de 3 GB de downloads (pacotes do sistema, Chromium, o modelo Whisper de 1,6 GB). Diga qual sistema o doctor encontrou (macOS, Linux ou WSL 2).
- Verifique: execute
bash scripts/setup/doctor.sh. Resuma as linhas NEED em palavras simples (para que serve cada uma), depois as linhas OPT em uma frase. - Ferramentas do sistema.
- macOS sem Homebrew: peça para eles executarem o instalador oficial de https://brew.sh no Terminal eles mesmos (pede a senha), depois siga as linhas "Next steps" que ele imprime.
- Linux / WSL 2: peça para eles executarem
bash scripts/setup/install.sh systemem seu próprio terminal (apt precisa da senha; também compilawhisper-clie instala Node 22 e uv). No Linux ARM, ele imprime uma linhaexport HYPERFRAMES_BROWSER_PATH=…para adicionar ao perfil do shell. Aguarde "concluído", depois execute doctor novamente.
- Escolha as instalações com uma AskUserQuestion (multiSelect). Ofereça apenas o que doctor marcou como ausente:
- "Core studio" =
install.sh coreno macOS (ferramentas Homebrew, venv Python, habilidades Claude, plugins Claude); no Linux/WSL 2, após a etapasystem,install.sh venv skills plugins. Recomendado. - "Modelo Whisper, 1,6 GB" =
install.sh whisper-model(temporizações de palavras para legendas e verificações de voz). Recomendado. - "Pacotes Previs Studio" =
install.sh app(para reconstruir o Previs Studio e executar suas verificações). - "onetake" =
install.sh onetake: experimentos pessoais e não comerciais apenas (PolyForm Noncommercial). - "Motion Reel Kit" =
install.sh motion-reel <pasta do kit>: apenas se eles compraram ou baixaram o kit de seu criador (vejaCREDITS.md); não está neste repositório. Execute as etapas aprovadas a partir da raiz do workspace. Etapas longas (brew, whisper-model) vão em segundo plano; diga a eles o que está sendo executado. Uma etapa imprimeFAIL …com a correção: tente a correção uma vez, depois explique e pergunte.
- "Core studio" =
- Preferências deles. Copie
OWNER.example.mdparaOWNER.md, depois faça as perguntas em uma ou duas rodadas de AskUserQuestion (nome, o que fazem, uso pessoal ou comercial, experiência em design de movimento, voz padrão, nível de qualidade, orçamento e aprovações). Escreva as respostas emOWNER.mdnas palavras deles. Ele é ignorado pelo git e nunca compartilhado. - Chaves de API. Pergunte com AskUserQuestion quais eles querem agora:
- Fish Audio (necessário para cada narração; conta gratuita; o modelo gratuito
s2.1-pro-freeé gratuito até 2026-11-30): chave em https://fish.audio/app/api-keys/. - Freesound (opcional; apenas para pesquisar e baixar novos efeitos sonoros; conta gratuita): solicite em https://freesound.org/apiv2/apply/ e copie "Client secret/Api key" e "Client id".
Então peça para eles executarem
bash scripts/setup/keys.shem seu próprio terminal: - No aplicativo de desktop Claude, se você tiver uma ferramenta de terminal (
run_in_terminal), iniciecd "<workspace>" && bash scripts/setup/keys.shno painel Terminal deles e diga para eles digitarem lá. Não leia o painel enquanto eles digitam. - Caso contrário, peça para eles abrirem um terminal (Terminal no macOS, terminal Linux ou WSL) e colar:
cd <workspace> && bash scripts/setup/keys.sh. Quando eles disserem que está concluído, executebash scripts/setup/doctor.sh --online. Ele confirma que as chaves funcionam sem mostrá-las.
- Fish Audio (necessário para cada narração; conta gratuita; o modelo gratuito
- Extras opcionais (uma lista curta, eles escolhem):
- Diffusion Studio (corte de filmagens reais, máscaras de objetos): no macOS eles baixam o aplicativo de https://diffusion.studio, abrem uma vez, depois você executa
install.sh diffusion-mcp. No Linux, ele funciona como um aplicativo web (https://app.diffusion.studio) sem o MCP. - O conector Fish Audio no claude.ai (Configurações → Conectores). Não é necessário; os scripts usam a chave.
- Remotion é gratuito para indivíduos e empresas de até 3 pessoas; empresas maiores precisam de uma licença Remotion.
- Diffusion Studio (corte de filmagens reais, máscaras de objetos): no macOS eles baixam o aplicativo de https://diffusion.studio, abrem uma vez, depois você executa
- Finalizar. Escreva
.local/setup.json(crie.local/; ele é ignorado pelo git):Execute{"owner": "<primeiro nome>", "setup_at": "<horário UTC de date -u +%Y-%m-%dT%H:%M:%SZ>", "by": "workspace-setup", "doctor": "<a linha DOCTER>"}bash scripts/setup/session-check.sh(agora não deve imprimir nada) e doctor mais uma vez. Relate o que está pronto e o que foi ignorado. - Diga a eles o que vem a seguir:
- Inicie uma nova sessão do Claude Code nesta pasta. Habilidades, plugins e o Diffusion MCP carregam apenas no início da sessão.
- Abra a demonstração:
python3 -m http.server 8790 --directory _shared/previs/studio, depois http://localhost:8790 (Previs Studio com o filme de demonstração Crumb). - Um primeiro prompt para experimentar: "Crie um vídeo de lançamento de 15 segundos para . Previs primeiro."
Reexecutando
Execute bash scripts/setup/doctor.sh a qualquer momento. bash scripts/setup/install.sh <etapa> repete uma etapa com segurança. Exclua .local/setup.json para executar toda esta configuração novamente.