O KubeCut acompanha canais de origem, cria vídeos verticais e publica em até cinco canais do YouTube. A fila persistente permite interromper e retomar o computador sem perder o progresso nem recomeçar trabalhos concluídos.
O aplicativo desktop é o painel de controle da esteira. Nele é possível acompanhar os trabalhos, identificar falhas, consultar os vídeos produzidos e abrir os arquivos salvos. A automação continua sendo executada pelo núcleo Python; fechar a janela não deve ser usado como substituto para encerrar o processo pelo controle oferecido no próprio aplicativo.
YouTube RSS → fila → download → transcrição → corte ou roteiro
→ edição vertical → legenda/narração/imagens → renderização
→ validação → limite diário → upload retomável
- Detecta vídeos novos por RSS, sem consumir a cota da YouTube Data API.
- Transcreve pela Groq e usa Faster-Whisper local como alternativa.
- Planeja cortes e roteiros com Gemini, Groq, Ollama e heurística, conforme disponibilidade.
- Monta vídeos em 9:16 com FFmpeg, legendas, música, voz Piper e imagens do Pexels.
- Valida resolução, duração, áudio e integridade antes de publicar.
- Mantém uma fila SQLite com tentativas, retomada, quarentena e proteção contra duplicidade.
- Autoriza e publica separadamente em cinco destinos, com um upload diário por destino.
O projeto não usa uma chave da OpenAI. Alguns nomes de modelos oferecidos por terceiros podem conter “OpenAI”, mas a autenticação continua sendo feita no respectivo provedor. Serviços externos gratuitos têm cotas e termos que podem mudar: custo zero, qualidade de API paga e uso literalmente ilimitado não podem ser garantidos ao mesmo tempo. Quando uma cota é atingida, o KubeCut tenta uma alternativa ou aguarda a liberação.
Para uma instalação nova no Windows, siga estes documentos na ordem:
- Instalação no Windows
- Configuração dos provedores e dos cinco canais
- Aplicativo desktop e operação diária
- Operação contínua, backup, segurança e atualização
- Solução de problemas
Instalação resumida para quem já possui Python, Node.js e FFmpeg configurados:
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install --upgrade pip
.\.venv\Scripts\python.exe -m pip install -e ".[automation,local-ai]"
.\.venv\Scripts\python.exe start.py init
cd desktop
npm ci
npm startO instalador Windows é produzido em desktop/dist por npm run build.
Na raiz do projeto:
.\.venv\Scripts\python.exe start.py doctor
.\.venv\Scripts\python.exe start.py automation statusO diagnóstico pode terminar com código diferente de zero enquanto itens opcionais estiverem ausentes. Para a automação, os itens indispensáveis são FFmpeg, FFprobe, yt-dlp, credenciais OAuth e pelo menos um caminho de processamento funcional para cada recurso usado pelos canais habilitados.
# Um ciclo, indicado para validar a configuração
.\.venv\Scripts\python.exe start.py automation run --once
# Serviço contínuo no terminal
.\.venv\Scripts\python.exe start.py automation run
# Estado da fila
.\.venv\Scripts\python.exe start.py automation statusArquivos importantes:
config/config.json: ferramentas, modelos, intervalos e caminhos;config/channels.json: fontes, destinos e políticas editoriais;.env: chaves externas, nunca versionadas;data/state/kubecut.db: fila e estado operacional;data/jobs/: arquivos intermediários de cada trabalho;data/output/: vídeos concluídos por comandos manuais.
Definir rights_confirmed: true é uma declaração do operador, não uma verificação jurídica. Use apenas
vídeos, músicas, imagens e vozes que você possa reproduzir, transformar e publicar. Automação não evita
reivindicações de copyright nem garante monetização. Antes de liberar publicação pública, valide o
resultado em modo private, confirme a identidade de cada destino e revise as regras atuais do YouTube.
.\.venv\Scripts\python.exe -m pytest
.\.venv\Scripts\python.exe -m ruff check .Os testes não devem fazer uploads reais nem usar contas reais. Para decisões de arquitetura, estado da implementação e limitações conhecidas, consulte RELATORIO_TECNICO.md.