Pular para o conteúdo

Pesquise guias, comandos, ferramentas MCP e arquitetura

Geral

Instalação e início rápido

Você pode clonar e hospedar apenas a edição de que precisa, sem depender da outra. Ambas rodam em Node.js e compartilham os mesmos binários de mídia e variáveis semelhantes no arquivo .env.

Dependência Quando é necessária Observação
Sistema operacional Obrigatório Linux (Kernel 5.4+, Ubuntu 22.04/24.04 LTS recomendados para FFmpeg) ou Windows 10/11
Node.js Obrigatório nos dois bots v20.x+ LTS no WhatsApp (node:test nativo); v22.x LTS recomendada no Discord
Memória RAM Obrigatória Mínimo de 1 GB livre; 2 GB recomendados se processar figurinhas animadas WebP ou vídeos pesados
FFmpeg no PATH Obrigatório nos dois bots Transcodificação Opus, streaming PCM da rádio, compressão de vídeo e figurinhas animadas
yt-dlp no PATH Obrigatório nos dois bots Extração e download de streams de áudio MP3 e vídeo MP4
Python 3.10+ e .venv Opcional Necessária para baixar músicas do catálogo Deezer em 320 kbps via deemix (requirements.txt)

Cada repositório traz instaladores na raiz para verificar os binários externos e configurar pacotes Node.js:

  • Windows: clique no arquivo setup.bat ou execute no PowerShell (.\setup.ps1 no WhatsApp).
  • Linux: dê permissão e rode o script na raiz do projeto:
Janela do terminal
chmod +x setup.sh
./setup.sh
  1. Clone o repositório e instale as dependências (discord.js, axios, cheerio, @gradio/client, entre outras):
Janela do terminal
git clone https://github.com/yGuilhermy/HikariDiscord.git
cd HikariDiscord
npm install
  1. Garanta permissão de escrita na pasta de dados (necessária para caches temporários como src/data/temp_images/, histórico opcional e banco JSON src/data/ai_database.json).
  2. Crie o arquivo de ambiente e preencha suas credenciais:
Janela do terminal
cp .env_example .env
node index.js
  1. Para manter rodando continuamente em servidor Linux com reinício automático:
Janela do terminal
npx pm2 start index.js --name hikari

No Discord, comandos globais registrados pela API (rest.put) podem levar até 5 minutos para aparecer no aplicativo após o primeiro boot. Reiniciar o cliente do Discord atualiza a lista na hora.

Diagnóstico prévio antes de conectar (HikariZap)

Seção intitulada “Diagnóstico prévio antes de conectar (HikariZap)”

A edição WhatsApp traz verificadores nativos que validam o .env, esquemas de ferramentas e testes automatizados sem abrir conexão com o WhatsApp:

Janela do terminal
npm run check
npm run config:check
npm run validate:tools
npm test

Os comandos /buscar_jogo (Discord) e >buscar_jogo / >torrent (WhatsApp) não ficam nos repositórios por questões de tamanho e direitos autorais; eles consultam índices locais em JSON na pasta src/data/:

  1. Baixe os catálogos JSON correspondentes aos repacks da FitGirl e do DODI pela Hydra Library.
  2. Salve ambos na pasta src/data/ da edição escolhida com os nomes exatos src/data/fitgirl.json e src/data/dodi.json.
  3. Reinicie o bot para carregar os índices em memória.

Servidores de nuvem frequentemente recebem bloqueio por faixa de IP do YouTube ao usar yt-dlp. Quando isso ocorrer em /baixar_musica ou >baixar_video, exporte os cookies necessários para um arquivo cookies.txt no servidor e informe o caminho dele na variável YTDLP_COOKIES_PATH (ou configure rotação de proxy/User-Agent no ambiente).