Monitora lives da Twitch, Kick e YouTube 24h por dia. Quando acontece algo bom (o chat explode, o streamer grita ou dezenas de viewers clipam ao mesmo tempo), ele corta o momento, transcreve a fala com Whisper, pede para o Claude avaliar o lance, escolher o corte e escrever manchete, gancho e legendas em PT-BR (traduz quando o streamer fala inglês). Depois monta o vídeo pronto para postar e manda no seu Telegram, com a legenda do post pronta para copiar.
Você decide o que vale a pena: cada momento chega primeiro como uma prévia leve, e a IA só é chamada (e só gasta) se você tocar em Analisar.
live ──► streamlink + ffmpeg ──► buffer circular em disco (últimos ~10 min, segmentos de 6s)
│
├─ chat (Twitch IRC · YouTube Data API · webhook oficial da Kick) ─┐
├─ volume do áudio (gritos, risadas) ├─► detector de momento
└─ "chuva de clipes" (Twitch Helix: muitos viewers clipando junto) ─┘
│
Telegram ◄── vídeo 4:5 ou 9:16 ◄── ffmpeg + legendas ◄── Claude ◄── Whisper ◄─┘
(prévia → você aprova → clipe final com botões ✅ Postei / 🗑 Descartar / 📷 Câmera errada)
- Detecção: compara o ritmo do chat com o normal do canal e conta mensagens de reação
(
kkkk,LMAO,KEKW, 💀…). Ignora sorteios, propaganda e bots. Em canais sem chat, usa picos de volume. - Curadoria com IA: o Claude recebe a transcrição com tempos e o chat do momento, dá uma nota de 0 a 10, escolhe início e fim sem cortar no meio de uma frase e escreve gancho, manchete, legenda do post e legendas na tela. A resposta vem em JSON validado por schema.
- Câmera do streamer: detecta e reconhece o rosto (OpenCV YuNet + SFace) para colocar a webcam em cima e o jogo embaixo. Pelo Telegram você corrige com um toque, e o sistema aprende.
- Layouts: "notícia" (4:5, clipe + manchete fixa, seis temas) ou vertical 9:16 com seis estilos de legenda (karaokê, neon, HQ…).
- Travas de gasto: orçamento diário em dólar, limite de análises por hora e comando
/saldocom o gasto real de cada clipe.
- Windows 10/11. Usa as fontes do Windows e o PowerShell para limpar gravadores órfãos. Roda em outros sistemas com pequenos ajustes.
- Python 3.13 e ffmpeg no PATH.
- GPU NVIDIA (opcional): o Whisper
large-v3-turboe o encoder NVENC ficam bem mais rápidos. Sem GPU, o programa usa CPU automaticamente. - Contas e chaves:
- Obrigatórias: Anthropic API e um bot do Telegram (crie com o @BotFather; seu chat ID sai com o @userinfobot).
- Opcionais: Twitch, YouTube Data API e Kick + ngrok.
git clone https://github.com/<seu-usuario>/<repositorio>.git
cd <repositorio>
python -m venv .venv
.venv\Scripts\pip install -r requirements.txt
copy .env.example .env # preencha as chaves
copy config.example.toml config.toml # ajuste canais, @ e estiloNa primeira execução, os modelos de rosto (cerca de 40 MB) são baixados do OpenCV Zoo e conferidos por SHA-256.
- Ligar: dois cliques em
iniciar.bat. Se o programa cair, ele reinicia sozinho. - Testar com qualquer canal ao vivo:
.venv\Scripts\python.exe -m clipper.teste twitch:alanzoka:pt - Monitorar outro canal sem mexer no config:
iniciar.bat --canal twitch:xqc:en
| Comando | O que faz |
|---|---|
/status |
Canais ao vivo, atividade do chat, fila e disco |
/clip kai |
Corta agora os últimos ~60s daquele canal |
/refazer 25 |
Refaz o vídeo do clipe 25 (câmera, legenda) sem gastar IA |
/saldo |
Gasto com a IA e saldo estimado (/saldo 25.00 informa o saldo do Console) |
| Prévia: ✅ Analisar · 🗑 Descartar · 🎬 Trecho inteiro | Você decide antes de gastar IA |
| ✅ Postei · 🗑 Descartar · 📷 Câmera errada | Histórico e correção da câmera com um toque |
- Muitos clipes ruins: aumente
multiplicador_minimo,min_msgsdo canal ounota_minima. - Poucos clipes: diminua esses mesmos valores.
- Visual:
layout_video(noticiaouvertical),tema_noticia,estilo_legenda. - Câmera:
layoutdo canal:auto(padrão),fundooufacecamcom posição fixa. - Fotos de referência: coloque 1 a 3 fotos do rosto do streamer em
rostos/<canal>/(vejarostos/LEIA-ME.txt). - Logo do selo: coloque sua foto de perfil em
assets/avatar.png. Sem ela, o código desenha um logo padrão.
Os dados (buffer, clipes, clipper.log, clips.db) ficam em pasta_dados, ou na pasta data/
do projeto se ela estiver vazia. Os clipes são apagados sozinhos depois de dias_guardar_clipes.
- Segredos: chaves só no
.env, que fica fora do git (veja.env.example). - Telegram: o bot só obedece ao
TELEGRAM_CHAT_IDconfigurado. Comandos e botões de outros chats são ignorados. - Webhook da Kick: escuta só em
127.0.0.1(exposto pelo túnel ngrok) e descarta qualquer mensagem sem assinatura RSA válida da Kick. - Prompt injection: chat, títulos de clipes e transcrição são tratados como dados não
confiáveis. O texto chega limpo à IA (sem
<>nem quebras de linha, e com tamanho limitado), e o prompt proíbe seguir instruções vindas dali. A saída é validada por JSON schema, os links são removidos e o tamanho é limitado. Mesmo assim, revise cada clipe antes de postar: o fluxo foi feito para ter um humano no meio. - APIs oficiais: chat e clipes usam as APIs oficiais (Twitch IRC/Helix, YouTube Data API, Kick Public API). O vídeo é gravado pelo streamlink.
- Respeite os termos de uso das plataformas e os direitos dos criadores. Poste cortes só de quem permite, dando o crédito, e nunca para se passar pelo streamer.
- Cada análise da IA custa centavos de dólar (o gasto aparece em cada clipe). Configure
orcamento_diario_usdantes de deixar rodando 24h.
Código sob a licença MIT. Fontes Anton e Archivo Black sob a SIL Open Font License.