Pular para o conteúdo

Pesquise guias, comandos, ferramentas MCP e arquitetura

Hikari WhatsApp

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).

  • Sistema operacional: Linux (Ubuntu 22.04 / 24.04 LTS recomendado) ou Windows 10/11.
  • Node.js: versão v20.x ou superior (LTS) (necessária para a suíte node:test nativa).
  • Memória RAM: mínimo de 1 GB livre (2 GB recomendados ao converter figurinhas animadas WebP e vídeos).
  • Binários recomendados no PATH: ffmpeg e yt-dlp.
  • Python 3.10+ (opcional): necessário apenas para downloads musicais em 320 kbps pelo Deezer (deemix).

Para instalar com os scripts da raiz:

  • Windows: execute setup.bat ou .\setup.ps1 no PowerShell.
  • Linux: chmod +x setup.sh && ./setup.sh.

Passo a passo manual:

  1. Clone o repositório e instale os pacotes Node.js:
Janela do terminal
git clone https://github.com/yGuilhermy/HikariWhatsapp.git
cd HikariWhatsapp
npm install
  1. (Opcional) Crie o ambiente virtual Python para o comando >musica via Deezer:
Janela do terminal
python3 -m venv .venv
./.venv/bin/pip install -r requirements.txt

No Windows PowerShell, use python -m venv .venv e .\.venv\Scripts\python.exe -m pip install -r requirements.txt.

  1. Copie o modelo de configuração, informe seu telefone com DDI e DDD em WHATSAPP_OWNER_NUMBERS e adicione suas chaves de IA:
Janela do terminal
cp .env_example .env
  1. (Opcional) Baixe os índices fitgirl.json e dodi.json pela Hydra Library e salve em src/data/ para usar >buscar_jogo e >torrent.

Antes de subir a conexão Baileys, você pode validar o .env, esquemas de tools e testes offline:

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

Para iniciar o bot:

Janela do terminal
npm start

Na primeira inicialização, um QR Code ASCII aparece no terminal:

  1. No celular, abra o WhatsApp em Aparelhos conectados → Conectar um aparelho.
  2. Aponte a câmera para o QR Code no terminal.
  3. 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.