Pular para o conteúdo

Pesquise guias, comandos, ferramentas MCP e arquitetura

Referência técnica

Variáveis de ambiente (.env)

Cada instância lê apenas o próprio arquivo .env na raiz do diretório. O Gerador de config permite ajustar opções comportamentais e baixar o modelo com placeholders locais sem digitar suas credenciais no navegador.

Serviço Link oficial Uso nos bots
Discord Developer Portal discord.com/developers/applications DISCORD_TOKEN e DISCORD_CLIENT_ID
Google AI Studio aistudio.google.com/app/apikey Chaves GEMINI_API_KEY (aceita múltiplas separadas por vírgula)
Groq Cloud console.groq.com Chat de baixa latência (GROQ_*) e Whisper STT
Hugging Face huggingface.co/settings/tokens Modelos Qwen / FLUX.1 e Space ZeroGPU XTTS v2
Stability AI platform.stability.ai/account/keys Geração de imagens prioritária no Discord (STABILITY_API_KEY)
AI Horde aihorde.net/register Rede distribuída gratuita (0000000000 anônimo ou chave registrada)
Brave Search API api.search.brave.com/app/dashboard Pesquisa web em tempo real prioritária (BRAVE_API_KEY)
Wit.ai Console wit.ai Transcrição gratuita de chamadas e áudios (WIT_AI_KEY / WITAI_TOKEN)
OpenAI API Keys platform.openai.com/api-keys Endpoint opcional Whisper STT no WhatsApp (OPENAI_STT_KEY)
Deezer deezer.com (cookie arl no DevTools) Token DEEZER_ARL para downloads em MP3 320 kbps
Variável Padrão Função
DISCORD_TOKEN obrigatória Token secreto de conexão no Gateway do Discord
DISCORD_CLIENT_ID obrigatória ID da aplicação para registrar os 21 comandos Slash
OWNER_ID obrigatória Um ou mais IDs do dono separados por vírgula (o primeiro é o Dono Primário)
PREFIX @ Prefixo legado alternativo para gatilhos configurados
BOT_NAME Hikari Nome reconhecido no chat e nos gatilhos de chamada de voz
REQUIRE_TOS true Exige aceite via /aceitar_tos em novos servidores
SAVE_HISTORY true Grava histórico de prompts/respostas em src/data/historico.txt
DEFAULT_AUTOMOD true Ativa o AutoMod automaticamente em novos servidores
AUTOMOD_MODE both Modo do AutoMod (off, trigger, mcp ou both)
APPEAL_CHANNEL_ID opcional ID do canal destinado a revisões e apelações
LOG_WEBHOOK_URL opcional Webhook privado para encaminhar stdout e stderr (mantenha em canal restrito)
Variável Função
AI_DB_READ Habilita leitura e agregação (db_read); se false, bloqueia todas as outras abaixo
AI_DB_WRITE Habilita gravação de novos fatos (db_write)
AI_DB_EDIT Habilita edição de registros (db_edit)
AI_DB_DELETE Habilita exclusão de chaves não protegidas (db_delete)
Variável Função
GEMINI_API_KEY, GEMINI_MODEL, GEMINI_MODEL_FALLBACK Chaves com rotação em ordem (Ordered Retry) e modelos Gemini
GEMINI_URL, HF_API_URL, HF_TOKEN, HF_MODEL Endpoints OpenAI-compatible e token Hugging Face
LOCAL_LLM_URL, LM_STUDIO_API_KEY Endpoint local (LM Studio / Ollama, padrão http://localhost:1234/v1/chat/completions)
STABILITY_API_KEY, HORDE_API_KEY Chaves de geração de imagens (/ia_imagem; Stability suporta Random Load Balancing entre múltiplas chaves)
BRAVE_API_KEY, DEEZER_ARL (ou DEEMIX_ARL) Pesquisa web prioritária e downloads musicais MP3 320 kbps
WIT_AI_KEY, GROQ_API_KEY Transcrição contínua em call e histórico sob demanda via Whisper
HF_TTS_ENDPOINT, MODAL_TTS_ENDPOINT, VOICE_* Endpoints XTTS v2 e ajustes VOICE_CHAT_ENABLED, VOICE_SPEED, VOICE_TEMPERATURE, VOICE_MAX_CHARS