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.
Requisitos de sistema
Seção intitulada “Requisitos de sistema”| 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) |
Método rápido com instaladores
Seção intitulada “Método rápido com instaladores”Cada repositório traz instaladores na raiz para verificar os binários externos e configurar pacotes Node.js:
- Windows: clique no arquivo
setup.batou execute no PowerShell (.\setup.ps1no WhatsApp). - Linux: dê permissão e rode o script na raiz do projeto:
chmod +x setup.sh./setup.shPasso a passo manual por edição
Seção intitulada “Passo a passo manual por edição”- Clone o repositório e instale as dependências (
discord.js,axios,cheerio,@gradio/client, entre outras):
git clone https://github.com/yGuilhermy/HikariDiscord.gitcd HikariDiscordnpm install- 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 JSONsrc/data/ai_database.json). - Crie o arquivo de ambiente e preencha suas credenciais:
cp .env_example .envnode index.js- Para manter rodando continuamente em servidor Linux com reinício automático:
npx pm2 start index.js --name hikariNo 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.
- Clone o repositório e instale os pacotes Node.js:
git clone https://github.com/yGuilhermy/HikariWhatsapp.gitcd HikariWhatsappnpm install- (Opcional) Crie o ambiente virtual Python para habilitar o comando
>musicavia Deezer 320 kbps:
python3 -m venv .venv./.venv/bin/pip install -r requirements.txtNo Windows PowerShell, use python -m venv .venv e .\.venv\Scripts\python.exe -m pip install -r requirements.txt.
- Copie o arquivo de exemplo, defina seu número com DDI+DDD em
WHATSAPP_OWNER_NUMBERSe inicie a sessão:
cp .env_example .envnpm start-
Na primeira execução, o terminal exibe um QR Code ASCII:
- No celular, abra o WhatsApp em Aparelhos conectados e toque em Conectar um aparelho.
- Aponte a câmera para o QR Code no terminal.
- Aguarde a confirmação no console (
Login confirmado. Hikari Zap conectada; chats privados e grupos.). Nas próximas inicializações a reconexão acontece sozinha.
-
Para manter em segundo plano na VPS Linux sem cair quando fechar o terminal SSH:
tmux new -s hikarizap "node index.js"Os arquivos da sessão ficam protegidos em .whatsapp-auth/ (permissão 0700) com trava contra processo duplicado em hikari-process.lock. Nunca apague .whatsapp-auth/ a menos que queira desvincular o aparelho.
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:
npm run checknpm run config:checknpm run validate:toolsnpm testCatálogo local de jogos (FitGirl e DODI)
Seção intitulada “Catálogo local de jogos (FitGirl e DODI)”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/:
- Baixe os catálogos JSON correspondentes aos repacks da FitGirl e do DODI pela Hydra Library.
- Salve ambos na pasta
src/data/da edição escolhida com os nomes exatossrc/data/fitgirl.jsonesrc/data/dodi.json. - Reinicie o bot para carregar os índices em memória.
Downloads em VPS de nuvem (Oracle Cloud e AWS)
Seção intitulada “Downloads em VPS de nuvem (Oracle Cloud e AWS)”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).
