Arta Edit Studio — setup
Prepare um clone recém-baixado para os comandos /reel-story e /reel-split e, em seguida, personalize-o.
Explique cada etapa em uma frase simples antes de executá-la — muitos usuários não são
desenvolvedores. Pergunte antes de baixar ou instalar qualquer coisa (pacotes, fontes,
pesos de modelo) e informe aproximadamente o tamanho.
Argumentos: $ARGUMENTS
1. Verificar a máquina — relate como uma tabela ✅ / ❌
| Necessidade | Verificação | Correção se faltar |
|---|---|---|
| Python ≥ 3.10 | python --version | python.org |
| Node ≥ 18 | node --version | nodejs.org (LTS) |
| ffmpeg com zscale | ffmpeg -hide_banner -filters contém zscale | Windows: build "full" do gyan.dev · macOS: brew install ffmpeg |
| GPU NVIDIA (opcional) | nvidia-smi | nenhuma → Whisper roda na CPU, ~10× mais lento |
| Chrome para renderização | npx hyperframes doctor (após etapa 2) | o doctor informa o que fazer |
2. Instalar (pergunte primeiro)
python -m venv .venv- PyTorch — o comando do pytorch.org para este SO; com GPU NVIDIA escolha a build CUDA (~2,5 GB), senão CPU.
.venv/Scripts/python -m pip install -r requirements.txt(macOS/Linux:.venv/bin/python).npm install(renderizador HyperFrames, GSAP, ícones Lucide).npx hyperframes doctor— corrija o que ele apontar.- Informe ao usuário: o modelo Whisper
large-v3(~3 GB) será baixado na primeira transcrição.
3. Fontes
Leia a seção fonts no arquivo de configuração. Para cada arquivo ausente de font/, informe ao usuário
de onde vem a fonte gratuita padrão e ofereça-se para baixá-la (pergunte primeiro):
- Farsi
Vazirmatn-Medium.ttf— github.com/rastikerdar/vazirmatn (releases), OFL - Latim
Poppins-SemiBold.ttfe displayPoppins-Black.ttf— fonts.google.com/specimen/Poppins, OFL
Qualquer outra fonte funciona: coloque o arquivo em font/ e altere o caminho no arquivo de configuração.
4. Configuração pessoal
Se reel.config.json não existir, copie reel.config.example.json para ele e, em seguida, pergunte
em uma única mensagem (pule o que os argumentos já responderam):
- nome e identificador do Instagram (para o cartão de seguir)
- idioma falado dos vídeos (
fa,en,ar,de, …) - nome da marca/produto (opcional) e suas cores — ou um arquivo de logotipo para extrair cores
- imagens de mascote/personagem (opcional) → coloque-as em
assets/mascot/; um logotipo →assets/brand/logo.png - onde estão seus clipes de B-roll (padrão
assets/broll/)
Escreva as respostas em reel.config.json (mantenha todas as chaves que o exemplo possui).
5. Teste de fumaça
.venv/Scripts/python -X utf8 -c "import sys; sys.path.insert(0,'tools'); import config, story_build, showcase_build; print('tools ok')"- Se um vídeo já estiver em
raw/:$PY tools/face_track.py <take>deve imprimir a posição do rosto.
6. Entrega
Imprima um pequeno "como usar" com um exemplo de cada, no idioma do usuário:
/reel-story <take> <tópico, palavra-chave de comentário, nomes> e /reel-split <take> ….