Pular para o conteúdo

Pesquise guias, comandos, ferramentas MCP e arquitetura

Hikari Discord

Instalação no Discord

Este guia detalha como preparar o ambiente, instalar dependências e iniciar uma instância própria da Hikari Discord.

  • Sistema operacional: Linux (Kernel 5.4+, recomendado para melhor desempenho com FFmpeg) ou Windows 10/11.
  • Node.js: versão v22.x (LTS) recomendada.
  • Memória RAM: mínimo de 1 GB livre para fila de IA e transcodificação.
  • Binários obrigatórios no PATH: yt-dlp e ffmpeg.
  • Python 3.10+ (opcional): necessário caso habilite downloads em 320 kbps pelo Deezer via deemix.

Na raiz do repositório existem scripts que verificam o ambiente e instalam as dependências automaticamente:

  • Windows: execute setup.bat.
  • Linux: dê permissão de execução e rode o script:
Janela do terminal
chmod +x setup.sh && ./setup.sh
  1. Clone o repositório e instale os pacotes Node.js (discord.js, axios, cheerio, @gradio/client, entre outros):
Janela do terminal
git clone https://github.com/yGuilhermy/HikariDiscord.git
cd HikariDiscord
npm install
  1. Garanta permissão de escrita no diretório src/data/ (utilizado para src/data/temp_images/, histórico opcional e banco src/data/ai_database.json).
  2. Copie o modelo de variáveis e configure suas credenciais no .env:
Janela do terminal
cp .env_example .env
  1. Opcionalmente, adicione os catálogos de jogos baixados da Hydra Library como src/data/fitgirl.json e src/data/dodi.json para habilitar /buscar_jogo.

Para testar no terminal:

Janela do terminal
node index.js

Para manter rodando continuamente com reinício automático em caso de queda:

Janela do terminal
npx pm2 start index.js --name hikari
  • Propagação de comandos Slash: comandos globais registrados via rest.put podem levar até 5 minutos para aparecer na interface do Discord após a primeira inicialização. Reiniciar o cliente do Discord atualiza o cache local na hora.
  • Bloqueios em nuvem: servidores na Oracle Cloud ou AWS podem precisar de cookies.txt (YTDLP_COOKIES_PATH) ou proxy rotativo para evitar bloqueios por faixa de IP no YouTube.