antares-agents
v0.2.1
Published
Framework agêntico para criação e manutenção de canais dark no YouTube, instalado por pasta via NPX
Downloads
507
Maintainers
Readme
Antares
Framework agêntico para criação e manutenção de canais dark no YouTube, no modelo do Reversa e do Mira: cada skill é um agente, cada agente tem um comando slash, e o trabalho vira arquivo numa pasta do projeto. Cada canal é uma pasta com uma instalação limpa do Antares; a identidade e a conexão do canal são geradas pelos próprios agentes, dentro do Claude Code.
Esteira: pesquisa de tema, roteiro, produção de mídia (Mira e/ou B-roll + narração), empacotamento (título, thumbnail, descrição), publicação agendada no YouTube (vertical e horizontal) e análise que retroalimenta a estratégia.
Instalação
Requisitos: Node 18+, ffmpeg e ffprobe no PATH. Voz padrão: pip install edge-tts.
mkdir meu-canal && cd meu-canal
npx antares-agents install # pergunta se instala o Mira junto (--com-mira / --sem-mira)
npx antares-agents update # atualiza skills e runtime; nunca toca em _antares/
npx antares-agents doctor # dependências, Mira, conexão, MCPs (--online testa a conexão)Depois, abra a pasta no Claude Code e digite /antares.
Primeiro vídeo no ar
/antaresaponta/antares-config: projeto no Google Cloud, APIs, tela de consentimento, credencial "App para computador", autorização no navegador e teste. Termina com os avisos de cota, auditoria e app em produção./antares-estrategia: nicho, idioma, país, público, tom, conteúdo infantil (sempre perguntado), motor de vídeo, voz, formatos, horários, política de fontes reais e revisões humanas./antares-pesquisa: temas priorizados com vidIQ + Ubersuggest no mercado do canal./antares lote 4: roteiro, produção e pacote de 4 itens, parando só nas revisões configuradas./antares-fila: horários no fuso do canal, sem conflito, com alerta de estoque./antares-publicar: upload compublishAt; o YouTube publica sozinho, mesmo com o computador desligado.- Uma semana depois,
/antares-analise: relatório que o próximo/antares-pesquisacita.
Agentes
| Comando | O que faz |
|---|---|
| /antares | Lê o estado do canal e indica ou executa o próximo passo; /antares lote N |
| /antares-config | Conecta o canal ao YouTube (Google Cloud + OAuth), uma vez |
| /antares-estrategia | Define ou revisa a identidade do canal |
| /antares-pesquisa | Temas priorizados com prova de demanda |
| /antares-fontes | Fontes reais em cascata (oficial, licenciada, aberta, terceiro) com risco, só em canais de material real |
| /antares-roteiro | Roteiro em cenas, com sanduíche de comentário para trechos de terceiro |
| /antares-producao | Narração, visuais (Mira, Nimo, B-roll, fontes) e render vertical (1080x1920) e horizontal (1920x1080) |
| /antares-acabamento | Música, efeitos sonoros, loudness e checagem de políticas pelo EDITEX, quando o canal configura producao.acabamento |
| /antares-pacote | Título, descrição, tags e thumbnail escolhidos por score |
| /antares-fila | Agenda de publicação e alerta de estoque |
| /antares-publicar | Upload resumível e idempotente com agendamento nativo |
| /antares-analise | Relatório com recomendações |
Estrutura de uma pasta de canal
meu-canal/
├── .claude/skills/antares*/ agentes (do framework, substituídos no update)
├── .antares/ runtime (do framework, substituído no update)
│ ├── scripts/ CLIs com saída JSON usadas pelos agentes
│ ├── lib/ regras determinísticas (backlog, risco, fila, cota, upload...)
│ ├── schemas/ canal, backlog, fontes, pacote, publicacao
│ └── adapters/ voz, broll, animacao, render, fontes, publicacao
└── _antares/ dados do canal (nunca tocados pelo update)
├── canal.yaml identidade
├── conexao/ credenciais OAuth e chaves (no .gitignore)
├── backlog.yaml itens, status, aprovações, horários, histórico
├── producao/<id>/ pesquisa, fontes, roteiro, mídia, render, pacote, publicação
└── analise/ relatóriosRegras que ficam no código (não só na conversa)
- Status de item só muda pelo grafo do backlog (
ideia → publicadoé recusado), com histórico de agente e data. - Revisão humana configurada: nenhum item sai de
roteirizado,produzidoouempacotadosem aprovação registrada. - Gate de risco: item com fonte acima de
fontes.risco_maximo_autonão é agendado nem publicado sem aprovação. - Trecho de terceiro acima do teto é recusado; trecho de emissora com direitos esportivos é sempre risco alto e nunca vai para a thumbnail.
- Upload idempotente: a sessão resumível é gravada antes do primeiro byte; reexecutar retoma sem duplicar vídeo.
- Cota: o lote inteiro é recusado antes do primeiro upload se não couber no saldo do dia.
- Segredos (client secret, tokens, chaves, URI de sessão) nunca aparecem em saída de script.
Provedores
| Tipo | Padrão | Alternativas |
|---|---|---|
| Voz | edge-tts | silencio (rascunho mudo) |
| B-roll | pexels (chave gratuita em _antares/conexao/provedores.json) | cartela (gerado localmente) |
| Animação | mira (skill mira-history) | |
| Render | ffmpeg | |
| Fontes reais | oficial-web, wikimedia-commons, agencia-licenciada | |
Um provedor novo é um arquivo em .antares/adapters/<tipo>/<nome>.mjs com a mesma interface; trocar o provedor no canal.yaml não exige mudar os agentes.
Desenvolvimento
npm install
npm test # suíte completa, incluindo render real com ffmpeg e ensaio ponta a ponta simuladoRepositório no molde do Reversa e do Mira: bin/antares.js (CLI), lib/ (instalador), agents/ (skills), templates/antares/ (runtime copiado para .antares/), test/ (node --test, com servidor simulado do Google em test/mock-google.mjs).
A validação com conta real (publicação com a máquina desligada e ponta a ponta no Mira Animator Kids) está em docs/VALIDACAO_REAL.md.
