Hugging Face's logo

Spaces:
JuanCS-Dev
/
twitch-byte-bot
Sleeping

App Files Community
twitch-byte-bot / docs /OPERATIONS_GUIDE.md
JuanCS-Dev's picture
JuanCS-Dev
Upload folder using huggingface_hub (Vértice Elite Deploy)
dbe6486 verified
preview code
|
Raw History Blame Contribute Delete
3.66 kB

📖 Guia de Operação: BYTE AI (Manual Antiburro)

Versão: 1.0 (Março 2026) Objetivo: Operar o Byte com 100% de eficiência, sem quebras e com o máximo de performance.

1. Configuração Inicial (The "Must-Have")

1.1 Variáveis de Ambiente (.env)

O Byte não perdoa erros no .env. Certifique-se de preencher:

  • BYTE_DASHBOARD_ADMIN_TOKEN: Crie uma senha forte (32+ chars). Sem ela, a dashboard não salva nada.
  • NEBIUS_API_KEY: Sua chave da Nebius AI.
  • SUPABASE_URL / SUPABASE_KEY: Credenciais do seu banco de dados.
  • TWITCH_USER_TOKEN: Deve começar com oauth:.

1.2 O Banco de Dados (Supabase)

Certifique-se de que a extensão pgvector está ativa no seu banco Supabase. O Byte usa isso para a Memória Semântica.

2. Dashboard: O Centro de Comando

Acesse via http://localhost:8080 (ou sua URL de deploy).

2.1 Aba: Control Plane (Configuração)

Aqui você define quem o bot é.

  • Persona Studio: No final da página, abra o "Persona Studio".
    • Lore: Escreva a história do bot (ex: "Você é um assistente tático de Valorant").
    • Model Routing: Escolha Kimi-K2-Thinking para coaching e Kimi-K2.5 para chat.
  • Goals Scheduler: Adicione metas.
    • Interval: "Fale algo a cada 600 segundos".
    • Fixed Time: Use para eventos únicos. IMPORTANTE: O horário deve ser em UTC. Se você está no Brasil (BRT), subtraia 3 horas do horário desejado.
    • Cron: Use 0 20 * * 5 para "Toda sexta às 20h UTC".

2.2 Aba: Operation (Observabilidade)

  • Stream Health: Se a barra estiver vermelha, o chat está "morno" ou negativo. O Byte tentará intervir sozinho se a Autonomia estiver ligada.
  • Sentiment Scores: Veja em tempo real se o público está empolgado (Hype) ou confuso.

2.3 Aba: Clips Pipeline

  • Quando o Byte detectar um momento épico, o card aparecerá aqui.
  • O card terá um spinner (processando) e depois uma Thumbnail.
  • Você pode clicar em Edit para mudar o título na Twitch antes de postar.

3. Comandos de Elite (Chat Twitch)

O Byte entende linguagem natural, mas alguns comandos são otimizados:

3.1 Arte ASCII (Braille 2x4)

  • byte arte ascii do goku
  • byte ascii batman
  • Regra: Existe um cooldown de 30 segundos por canal. Se pedir rápido demais, ele ignora para evitar ban da Twitch.

3.2 Status e Ajuda

  • byte status: O bot reporta a saúde do sistema e o modelo que está usando.
  • byte help: Lista as capacidades básicas.

4. Resolução de Problemas (Troubleshooting)

Problema Causa Provável Solução
Dashboard não salva Token Admin errado ou ausente. Verifique o BYTE_DASHBOARD_ADMIN_TOKEN no seu .env e no campo de login da Dash.
Bot não responde Token Twitch expirado. O bot tenta renovar sozinho, mas se falhar, gere um novo token no Twitch Token Generator.
Erro de Modelo (Inference) Saldo na Nebius ou Model Name errado. Verifique seu dashboard na Nebius AI Studio.
ASCII Art borrada Imagem original com pouco contraste. Tente temas com silhuetas claras (logos, personagens de anime).

5. Regras de Ouro (Constituição Vértice)

  1. Nunca force um restart enquanto um clipe está em polling. Você perderá o rastro do job.
  2. Respeite o Orçamento (Budget): Se você configurou 10 mensagens por hora, o Byte vai parar de falar na 11ª. Ajuste isso no Control Plane se necessário.
  3. UTC é Vida: Lembre-se sempre que o servidor e o calendário falam em UTC.

Guia mantido por VÉRTICE Core Analytics — 2026