benchmark-system v1.1  ·  16,72 MB  ·  18 skills  ·  macOS e Linux

Você manda um @. Ele desmonta o que funciona.

Um sistema operacional de conteúdo que roda na sua máquina, dentro do seu agente de terminal. Descompacte, rode um comando, e comece a usar.

faz o benchmark do @fulano

Baixa os posts, ranqueia por outlier, transcreve os melhores, classifica gancho, estrutura e CTA, e escreve um dossiê.

salva essa referência: <link>

Analisa o vídeo, mede o encaixe com a sua linha editorial, e devolve o roteiro adaptado ao seu tom.

edita esse vídeo

Transcreve os brutos, escolhe os takes, corta os respiros, monta, e te mostra o corte para aprovar antes de entrar com legenda, gráficos e cor.

Tudo o que ele produz é markdown e JSON numa pasta. Sem banco de dados, sem conta em serviço nenhum, sem nada preso na nuvem de outra pessoa.

São dois, e um funciona sem o outro

Instale só o módulo que você vai usar

Módulo 1

Benchmarking e produção

Desmonta o que os outros fazem que funciona e devolve adaptado a você. Perfis, anúncios, funis, roteiros.

precisa de: python3 · jq · yt-dlp
chaves: Deepgram · Apify

Módulo 2

Ilha de edição

Transforma bruto em peça entregue, com uma tela de aprovação no meio. Legenda, gráficos, som e cor.

precisa de: python3 · jq · ffmpeg · node 22
chaves: Deepgram

Os dois conversam — o roteiro que sai do primeiro vira o vídeo que entra no segundo. Mas nenhum depende do outro. Se hoje você só quer olhar concorrente, instale o módulo 1 e ignore o resto.

Instalação

Do zero, numa máquina limpa

De 10 a 20 minutos, e a maior parte é download. Windows não roda direto: instale o WSL com Ubuntu e siga o caminho de Linux dentro dele.

Passo 0

Um agente de terminal

O sistema não é um programa que você abre. É um conjunto de instruções e scripts que um agente executa. Codex, Claude Code, Hermes e outros usam o mesmo AGENTS.md; quando não houver descoberta automática, há um prompt universal em COMPATIBILIDADE-AGENTES.md.

Passo 1

As dependências

# macOS — se você nunca instalou o Homebrew, instale primeiro
brew install python@3.13 node ffmpeg jq yt-dlp

# Ubuntu / Debian
sudo apt install -y python3 python3-pip ffmpeg jq curl
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

jq não é conveniência: a montagem o chama 15 vezes para ler o plano de corte, e sem ele para na primeira leitura de JSON.

Passo 2

O instalador

cd benchmark-system
./instalar.sh

Ele confere as dependências e nomeia cada uma que faltar, instala as duas bibliotecas Python, pergunta as chaves de API com a digitação oculta, e roda a verificação. Rodar de novo é seguro — ele pula o que já está pronto.

Passo 3

Só se você vai editar vídeo

cd tools/remotion-compositor
npm ci
npx remotion browser ensure

O motor de render é pesado e não faz falta para quem só quer benchmarking, por isso fica fora do instalador. Faça o segundo comando agora, não depois: o render busca um navegador próprio de 193 MB na hora do primeiro uso, e descobrir isso no meio de um trabalho parece instalação quebrada.

Passo 4

Conferir

./verificar.sh

Chaves de API (o valor nunca é impresso)
  DEEPGRAM_API_KEY   ✓ arquivo_local
  APIFY_TOKEN        ✓ arquivo_local
  GEMINI_API_KEY     ✗ ausente         → CHAVES-DE-API.md seção 3

────────────────────────────────────────────
Módulo 1 · Benchmarking e produção   PRONTO
Módulo 2 · Ilha de edição            falta: node_modules

Vermelho no módulo de edição não impede o de benchmarking de funcionar. Eles são independentes, e o relatório diz o que falta em cada um.

Passo 5

O seu creator

cp -r creators/_template creators/seunome

Abra creators/seunome/LINHA-EDITORIAL.md e responda. Ou, mais rápido: abra o agente na pasta e diga “me entrevista para preencher a minha linha editorial”.

Handle e pilares são obrigatórios. Sem eles o sistema não tem como avaliar se uma referência serve para você, e devolve roteiro genérico — que é justamente o que ele existe para não fazer.

Passo 6

O primeiro uso

Abra o agente normalmente na raiz da pasta. Use ./executar.sh somente no script pontual que consumir uma API. Para editar, ponha os brutos numa pasta e peça de lá:

codex  # ou claude, hermes, etc.
mkdir -p minha-peca/input
cp ~/Downloads/take*.mov minha-peca/input/
# e então, no agente:  edita isso num Reels

A tela de aprovação sobe antes de qualquer camada gráfica entrar. Sem o seu clique no botão de aprovar o corte, a fase gráfica não começa. Esse portão é executável, não uma recomendação.

As chaves de API

Três contas, nenhuma assinatura

Você paga por uso, em centavos, e as três têm crédito inicial ou camada grátis que costuma cobrir os primeiros meses. O instalador pergunta as três; pode pular qualquer uma e voltar depois.

Obrigatória
DEEPGRAM_API_KEY

Transcrição. É a única que trava um caminho inteiro: sem ela não há corte por fala, nem legenda, nem verificação de emenda.

Preço
US$ 0,0052 / minuto
Grátis
US$ 200 de crédito ≈ 640 h
  1. Crie a conta.
  2. Menu lateral → API Keys.
  3. Create a New API Key, permissão Member.
  4. Copie na hora — ela aparece uma vez só.
Obrigatória
APIFY_TOKEN

Posts do Instagram e criativos da biblioteca de anúncios. TikTok e YouTube continuam de graça pelo yt-dlp; Instagram, não.

Preço
US$ 2,30 / 1.000 posts
Grátis
US$ 5 por mês, renovando
  1. Crie a conta.
  2. Avatar → Settings.
  3. API & Integrations.
  4. Copie o token que começa com apify_api_.
Opcional
GEMINI_API_KEY

Leitura visual: carrossel, análise de edição alheia, geração de plano. Sem ela o sistema roda inteiro, só sem enxergar imagem.

Preço
≈ US$ 0,02 por reel
Grátis
camada grátis generosa
  1. Entre logado numa conta Google.
  2. Create API key.
  3. Aceite o projeto padrão.
  4. Copie a chave que começa com AIza.

O instalador grava as chaves fora do projeto, em ${BENCHMARK_SYSTEM_HOME:-~/.config/benchmark-system}/.env, com permissão 600. ./executar.sh injeta os valores somente no processo filho. Trocar de agente não exige copiar segredo nem editar cloud.json, settings.local.json ou equivalente.

Antes de mandar um log ou uma pasta para alguém, rode python3 tools/pacote/ambiente.py --scan-segredos --scan-dir .. Ele procura o valor das chaves sem imprimir nenhuma e diferencia “limpo” de “não medido”.

Custo real

Cerca de US$ 5 por mês, em ritmo alto

OperaçãoCustoO que entra nisso
Capturar 1 referênciaUS$ 0,06reel de 90s, transcrito e analisado
Self-review semanalUS$ 0,26extração do perfil + 3 posts
Benchmark de anuncianteUS$ 0,5060 anúncios com criativo + funil + 3 reels
Benchmark de perfilUS$ 1,1530 posts, 10 análises completas
Modelar uma ediçãoUS$ 0,06por minuto de vídeo
Plano gerado por IAUS$ 0,828 segundos — a única linha a vigiar

A última linha sobe rápido se você iterar o prompt: duas ou três tentativas chegam perto de US$ 2. E sem pedir a duração no prompt ele entrega 10 segundos em vez de 8, o que custa 20% a mais. Todo o resto é ruído perto da assinatura do agente que você já paga.

Quando não funciona

Os cinco erros que aparecem primeiro

SintomaCausa, quase sempre
DEEPGRAM_API_KEY não configuradaa chave não entrou. Rode ./instalar.sh de novo
download do Instagram falhapost que exige login. Exporte os cookies do navegador e aponte BENCH_COOKIES=/caminho/cookies.txt
jq: command not foundvolte ao passo 1
o render falha em 404 no primeiro framefaltou o npx remotion browser ensure do passo 3
npx remotion compositions reclama da configvocê rodou de fora da pasta. O cd é obrigatório: o motor resolve os caminhos pelo diretório corrente

Duas coisas que vale saber antes

O que ele não faz

Ele nunca inventa número seu. Quando um roteiro precisa de um caso real, de um resultado ou de uma prova, ele escreve [DADO REAL] e para, esperando você preencher. Um roteiro com número inventado é pior que um roteiro sem número nenhum.

Ele copia mecanismo, nunca texto. O que se rouba de uma referência é o tipo de gancho, a estrutura e o dispositivo de retenção. O assunto e as palavras continuam sendo seus.

E, no plano técnico: não roda em Windows sem WSL, não instala tudo com um comando só (o render é opt-in de propósito), e duas funções — recorte de pessoa por visão computacional e uma das vias de limpeza de áudio — dependem de binários que só existem em macOS com chip Apple. As outras vias funcionam em qualquer lugar.

Dentro do pacote, a documentação completa: LEIA-PRIMEIRO.md para começar, INSTALACAO.md para o passo a passo, CHAVES-DE-API.md para as contas, AGENTS.md para o contrato comum, COMPATIBILIDADE-AGENTES.md para cada runtime e EDICAO.md para o módulo de vídeo.

Uso concedido a quem recebeu o pacote. Redistribuição, não — os termos estão no LICENSE.