Praeko Studio: vídeos com o seu agente

O Praeko Studio faz vídeos curtos (9:16) e longos (16:9) a partir de um roteiro: voz, legenda palavra a palavra, cenas, capa e os textos de cada rede. Você opera com o seu próprio agente de código, na sua máquina: o agente escreve o roteiro e o episode.yaml, roda os comandos e, só depois do seu sim, publica pelo Praeko. A voz, o render e o agente são por sua conta; o Studio não chama nenhum modelo de linguagem e nenhum roteiro seu sai da máquina até você publicar.

Requisitos

Instalar

npm install -g @praeko/studio

yarn global add @praeko/studio

pnpm add -g @praeko/studio

bun add -g @praeko/studio

npx @praeko/studio doctor
npx @praeko/studio init my-channel

O comando é praeko-studio e também praeko studio … quando o @praeko/cli está instalado: ele entrega ao Studio, procurando no projeto, ao lado da CLI, na instalação global e no PATH.

Licenças: leia antes do primeiro render

O Remotion é o motor padrão dos vídeos e das capas; com --engine hyperframes o vídeo e a capa saem pelo HyperFrames e nada do Remotion é usado. Texto completo e fontes: praeko studio docs licenses (o LICENSES.md do pacote); praeko studio licenses --accept registra que você leu.

Seu primeiro vídeo em 10 minutos

praeko-studio doctor

praeko-studio init my-channel --name "My Channel" --agent claude
cd my-channel

Faça um Short de 40 segundos sobre <TEMA> neste projeto do Praeko Studio.
Leia as instruções do projeto e rode `praeko studio docs episode-yaml` antes de escrever o YAML.
Use a voz draft, mostre o roteiro e as cenas para eu aprovar antes de gastar crédito de voz,
rode check e contact-sheet, e não publique nada sem eu pedir.

praeko-studio new my-first --title "My first video"
praeko-studio voice my-first --quality draft
praeko-studio check my-first
praeko-studio render my-first --scale 0.5
praeko-studio contact-sheet my-first
praeko-studio cover my-first
praeko-studio package my-first

echo $PRAEKO_KEY | praeko-studio schedule --via praeko --key
praeko-studio schedule my-first --when "20/12 17:30" --via praeko

Comandos

Todos começam por praeko studio (ou praeko-studio). praeko studio --help lista o mesmo.

O projeto

my-channel/
  brand.json            # cores, fontes, handle, voz, links, hashtags
  voices.json           # (opcional) a sua voz; nunca chaves
  src/                  # index.ts, Root.tsx, brand.ts (o Root registra os episódios)
  public/               # sfx/, cover/avatar.png, audio/ (voz gerada)
  episodes/<slug>/
    script.txt          # o texto falado
    episode.yaml        # as cenas, declarativas
    scenes.tsx          # peças em TSX (capa e o que o YAML não cobre)
    publication.json    # textos de cada rede, hashtags, ai.synthetic
  out/                  # vídeos e capas renderizados

{
  "name": "My Channel",
  "handle": "@mychannel",
  "avatar": "cover/avatar.png",
  "colors": { "background": "#14110f", "accent": "#f4b942", "text": "#f3ece0" },
  "fonts": { "title": "'Arial Black', system-ui, sans-serif", "mono": "Menlo, monospace" },
  "links": { "main": "https://example.com/" },
  "voice": "draft-silent",
  "pronunciation": { "example.com": "example dot com" },
  "bannedNames": [],
  "publishing": { "provider": "praeko", "hashtags": { "allowed": [], "banned": [] } }
}

O episode.yaml é declarativo: cada item liga a uma frase da voz com when: "frase", e praeko studio compile confere. O que o YAML não cobre vira uma peça em scenes.tsx, feita com as peças do @praeko/studio-kit (panel, box, line, bubble, code, window, phone, frame). O render é uma função pura do episódio compilado e dos arquivos do projeto.

id: MyVideo
duration: 14
caption: 80
voice: audio/MyVideo.mp3
background: ["My video"]
outro: { start: 10, cta: FOLLOW THE PROFILE }
cover: { id: CoverMyVideo, component: CoverMyVideo }
scenes:
  - start: 0
    title: THE PROBLEM
    label: PROBLEM
    items:
      - { type: big, at: 0.2, color: accent, size: 92, text: "The cache took the deploy down" }
      - { type: box, when: "deploy", text: "cleared the cache" }

Formato completo: praeko studio docs episode-yaml, praeko studio docs long-yaml e, para um post de foto, praeko studio docs image.

Posts de imagem (uma foto)

praeko studio new <slug> --image cria uma peça de imagem: o mesmo publication.json, check, package e envio de um vídeo, mas sem roteiro, voz nem vídeo. O episode.yaml tem format: image e um slide (vários slides seriam um carrossel, que chega numa fase futura), que reaproveita os itens de uma capa e leva um texto alternativo (alt, obrigatório, até 1000 caracteres). praeko studio slides <slug> renderiza out/<slug>-slide-01.jpg em 1080x1350, JPEG sRGB (só com Remotion). O package grava as imagens e o alt no publication.json e o texts.md só com a legenda do Instagram. Só o Instagram aceita foto por enquanto (YouTube não tem post de imagem; a foto do TikTok é uma fase futura): praeko studio schedule <slug> --via praeko sobe a foto como mídia type: image e cria o post com kind: image. O alt vai pelo Instagram quando o Praeko publica pela Meta; pelo Buffer ele é ignorado e o item avisa alt_ignored.

Chaves e custos: você traz as suas

echo $ELEVENLABS_API_KEY | praeko-studio voice config key elevenlabs/principal
praeko-studio voice account add principal --voice my-voice --voice-id <YOUR_VOICE_ID>

praeko-studio voice account list
praeko-studio voice account add backup --from-env ELEVENLABS_API_KEY_2 --dry-run   # only checks the key and shows the plan, stores nothing
praeko-studio voice account add backup --from-env ELEVENLABS_API_KEY_2             # stores the key in the keychain and the voice in voices.json

Sem --from-env, o comando pede a chave no terminal (sem mostrá-la) ou lê da entrada padrão. --voice dá um apelido à voz e --voice-id informa o id; sem eles o comando procura o clone da sua voz na conta. Com mais de uma conta, o Studio escolhe pelo saldo e troca de conta se uma esgotar (--no-failover desliga).

A chave nunca vai para o projeto, o git, o log ou o chat com o agente. Use somente a sua voz ou uma voz que você tem autorização para usar. Detalhes: praeko studio docs voice.

Publicar pelo Praeko

O Studio não publica nada sozinho. Duas formas, as duas só depois do seu sim:

• CLI: praeko studio schedule <slug> --via praeko --when "dd/mm hh:mm" simula; com --send envia o vídeo e agenda de verdade. O YouTube sobe privado e agendado; o TikTok vai como rascunho.
• MCP do Praeko: um agente com shell envia o arquivo local com create_media_upload (um passo; devolve o curl), termina com complete_media_upload e cria o post com create_post ou schedule_post em dois passos: a primeira chamada devolve só a prévia e um confirmation_code; o agente mostra a prévia inteira a você e só repete a chamada com confirm depois do seu sim. Veja Servidor MCP.

Instruções para o seu agente

praeko-studio skill install --agent claude,codex,gemini,cursor,opencode,cline,windsurf --lang en

O texto traz o fluxo do vídeo, o envio de arquivo local, a regra de dois passos e a declaração de IA. Em arquivos compartilhados (AGENTS.md, CLAUDE.md, GEMINI.md) o Studio grava só um bloco delimitado e preserva o resto. Os formatos de cada agente mudam com o tempo: confira na documentação do seu agente.

Problemas comuns

Conteúdo gerado por IA e conformidade

Voz sintética realista, ou imagem e vídeo gerados que pareçam reais, exigem o rótulo de conteúdo alterado ou sintético no YouTube, o "AI info" no Instagram e o rótulo de conteúdo gerado por IA no TikTok. Preencha "ai": { "synthetic": true } no publication.json: check e package avisam quando falta. Na publicação direta do Studio o YouTube recebe o campo (containsSyntheticMedia); pelo caminho do Praeko e no Instagram e no TikTok você marca o rótulo no app da rede antes de publicar, porque a API pública do Praeko ainda não leva esse campo. As regras de cada rede mudam: confira a política vigente.