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.
Onde obter chaves de API externas
Seção intitulada “Onde obter chaves de API externas”| 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áveis por plataforma
Seção intitulada “Variáveis por plataforma”Obrigatórias e governança
Seção intitulada “Obrigatórias e governança”| 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) |
Memória JSON (ai_database.json)
Seção intitulada “Memória JSON (ai_database.json)”| 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) |
IA, mídia e voz
Seção intitulada “IA, mídia e voz”| 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 |
Conta, limites e logs
Seção intitulada “Conta, limites e logs”| Variável | Padrão / Faixa | Descrição |
|---|---|---|
BOT_NAME |
Hikari |
Nome de gatilho em grupos e assinatura EXIF padrão das figurinhas |
WHATSAPP_OWNER_NUMBERS |
obrigatório (8–15 dígitos) |
Telefones autorizados (DDI+DDD) separados por vírgula; recusa placeholders |
WHATSAPP_NOTIFY_OWNER |
false |
Avisa o proprietário em privado ao conectar |
WHATSAPP_AUTH_DIR |
.whatsapp-auth |
Diretório das credenciais Baileys e trava de instância |
WHATSAPP_DATA_DIR |
src/data/zap |
Pasta para ai-health.json, identities.json e caches |
WHATSAPP_MAX_MEDIA_MB |
16 (1 a 64) |
Teto em MB para download e envio de mídias |
SAVE_HISTORY |
true |
Mantém janela recente das últimas 15 mensagens em memória |
SYSTEM_PROMPT |
definido no código | Sobrescreve ou ajusta a diretriz de comportamento no WhatsApp |
LOG_DIR, LOG_LEVEL |
logs / info |
Pasta de saída e nível (debug, info, warn, error) |
LOG_RETENTION_DAYS, LOG_MAX_FILE_MB |
7 (1–90) / 5 (1–50) |
Retenção automática em dias e tamanho máximo de cada arquivo de log |
Pool multi-IA, fila, câmbio, voz e binários
Seção intitulada “Pool multi-IA, fila, câmbio, voz e binários”| Variável | Padrão / Faixa | Descrição |
|---|---|---|
AI_PROVIDER_ORDER |
groq,gemini,huggingface |
Ordem de seleção inicial no ProviderPool |
GEMINI_API_KEY, GEMINI_URL, GEMINI_MODEL, GEMINI_MODEL_FALLBACK, GEMINI_MODEL_FALLBACK_2, GEMINI_MODEL_FALLBACK_3 |
padrão gemini-3.1-flash-lite em diante |
Chaves em rotação e cadeia de modelos de contingência |
HF_TOKEN, HF_MODEL, HF_API_URL |
Qwen/Qwen2.5-72B-Instruct |
Fallback Hugging Face (https://router.huggingface.co/v1/chat/completions) |
LOCAL_LLM_ENABLED, LOCAL_LLM_URL, LOCAL_LLM_MODEL, LMSTUDIO_API_KEY |
false / http://localhost:1234/v1/chat/completions |
Servidor LLM local prioritário quando habilitado |
POLLINATIONS_API_KEY, ALLOW_PUBLIC_POLLINATIONS, POLLINATIONS_TEXT_URL, POLLINATIONS_MODEL |
false / https://text.pollinations.ai/openai |
Pollinations exige chave autenticada salvo quando ALLOW_PUBLIC_POLLINATIONS=true |
LLM_TIMEOUT_MS, QUEUE_* |
30000 (5000–120000 ms) |
Timeouts de chamada IA e limites da fila (QUEUE_CONCURRENCY, QUEUE_MAX_PENDING, QUEUE_MAX_PER_CHAT) |
BRAVE_API_KEY, HORDE_IMAGE_API_KEY |
opcionais | Pesquisa web Brave e geração distribuída de imagens AI Horde |
CURRENCY_PROVIDER, AWESOMEAPI_KEY |
awesomeapi (awesomeapi ou frankfurter) |
Provedor de câmbio ao vivo e chave opcional da AwesomeAPI |
GROQ_API_KEY, WITAI_TOKEN, OPENAI_STT_KEY, OPENAI_STT_URL, HF_STT_URL, LOCAL_STT_URL |
opcionais | Motores STT para >transcrever e áudios em DM |
HF_TTS_ENDPOINT, MODAL_TTS_ENDPOINT, VOICE_SPEED, VOICE_TEMPERATURE, VOICE_MAX_CHARS |
1.15 / 0.65 / 1000 (1–5000) |
Endpoints XTTS v2 e ajustes de síntese vocal PTT |
FFMPEG_PATH, YTDLP_PATH, PYTHON_PATH, YTDLP_COOKIES_PATH, DEEZER_ARL |
ffmpeg, yt-dlp, .venv auto |
Caminhos de binários, arquivo de cookies para vídeos e ARL do Deezer 320 kbps |
