Instalação e QR Code no WhatsApp
Este guia detalha como instalar, parear no celular via QR Code e validar o ambiente da HikariZap (WhatsApp).
Requisitos do sistema
Seção intitulada “Requisitos do sistema”- Sistema operacional: Linux (Ubuntu
22.04/24.04LTS recomendado) ou Windows10/11. - Node.js: versão v20.x ou superior (LTS) (necessária para a suíte
node:testnativa). - Memória RAM: mínimo de
1 GBlivre (2 GBrecomendados ao converter figurinhas animadas WebP e vídeos). - Binários recomendados no
PATH:ffmpegeyt-dlp. - Python 3.10+ (opcional): necessário apenas para downloads musicais em 320 kbps pelo Deezer (
deemix).
Instalação automática e manual
Seção intitulada “Instalação automática e manual”Para instalar com os scripts da raiz:
- Windows: execute
setup.batou.\setup.ps1no PowerShell. - Linux:
chmod +x setup.sh && ./setup.sh.
Passo a passo manual:
- 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 o comando
>musicavia Deezer:
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 modelo de configuração, informe seu telefone com DDI e DDD em
WHATSAPP_OWNER_NUMBERSe adicione suas chaves de IA:
cp .env_example .env- (Opcional) Baixe os índices
fitgirl.jsonedodi.jsonpela Hydra Library e salve emsrc/data/para usar>buscar_jogoe>torrent.
Pareamento por QR Code e execução
Seção intitulada “Pareamento por QR Code e execução”Antes de subir a conexão Baileys, você pode validar o .env, esquemas de tools e testes offline:
npm run checknpm run config:checknpm run validate:toolsnpm testPara iniciar o bot:
npm startNa primeira inicialização, um QR Code ASCII aparece no terminal:
- No celular, abra o WhatsApp em Aparelhos conectados → Conectar um aparelho.
- Aponte a câmera para o QR Code no terminal.
- Aguarde a confirmação
Login confirmado. Hikari Zap conectada; chats privados e grupos.. As credenciais ficam em.whatsapp-auth/(com trava contra processo duplicado em.lock) e reconectam automaticamente nas próximas execuções.
Em servidores Linux, execute dentro de uma sessão persistente como tmux new -s hikari "node index.js". Nunca apague .whatsapp-auth/ a menos que queira desconectar o número.
