Yuki Bot

Yuki e uma bot de comunidade para WhatsApp, feita para grupos que precisam de moderacao, entretenimento, downloads, economia, painel web e uma IA com personalidade propria.

Ela nao e so um bot de comandos soltos: a proposta atual da Yuki e ser uma central de grupo, com aluguel, painel, automacoes e ferramentas para admins e usuarios.

O projeto e livre para alteracoes no codigo, mas nao pode ser vendido como se fosse seu. Mantenha os creditos para Speed e Lenoz7.

O que a Yuki faz

• Moderacao de grupos: ban, add, promover, rebaixar, mute, advertencias, anti-link, anti-marcacao e boas-vindas.
• Painel web: entrada por link/codigo, visao de grupos, configuracoes, acoes administrativas, bolao e anuncios.
• Aluguel e VIP: fluxo com Mercado Pago, grupos ativos por vencimento e bypass para donos/VIP.
• IA e imagens: comandos de IA, respostas automaticas configuraveis e geracao de imagem.
• Downloads e buscas: TikTok, Instagram, YouTube/play, Pinterest, stalks e API local de TikTok.
• Economia e perfil: saldo, diario, transferencia, rank, namoro, apostas e loja de waifus.
• Figurinhas: criar sticker com /s ou /fig, criar meme com /fig meme, criar sticker de texto com /fig texto, criar legenda/quote com /fig legenda e /fig quote, ajustar encaixe com /fig fit, /fig crop e /fig stretch, salvar biblioteca do grupo, renomear sticker e converter sticker para imagem/video.

Status do produto

O foco atual e transformar a Yuki em um produto mais claro e confiavel:

• reduzir ruido no grupo;
• manter menu e comandos consistentes;
• melhorar README/onboarding;
• tratar painel e aluguel como partes principais;
• deixar IA ambiente e tom da Yuki mais configuraveis;
• criar checks pequenos para evitar regressao.

O plano vivo fica em docs/yuki-product-roadmap.md.

Requisitos

• Node.js 18 ou superior.
• Git.
• WhatsApp para pareamento.
• FFmpeg para comandos de midia.
• MongoDB.
• Redis.
• Chaves externas conforme uso: Groq/OpenAI-compatible para IA, ZeroTwo API para alguns comandos, Mercado Pago para aluguel, Spotify/Discord se essas integracoes forem usadas.

Instalar

git clone https://github.com/speedxzpdev/YukiV3
cd YukiV3
npm install

Copie o arquivo de ambiente e preencha as chaves:

cp .env.exemple .env

Depois ajuste pelo menos:

• PREFIXO
• URIDB
• REDIS_HOST, REDIS_PORT, REDIS_PASSWORD quando aplicavel
• AI_KEY
• AI_AUTOREPLY_DEFAULT se quiser IA ambiente ligada por padrao em grupos novos
• ZEROTWO_APIKEY
• APIKEY_MERCADOPAGO
• PORT
• URL_BACKEND
• SECRET
• SPEED_LID e LENOZ_LID

Rodar

sh start.sh

No Windows, use o start.bat quando o ambiente estiver configurado para isso.

Checks uteis

npm test
npm run check
npm run check:syntax
npm run check:menu

npm test roda os checks estaticos principais. Hoje isso valida sintaxe dos arquivos JS em src e confere se os comandos citados no menu possuem handler ou alias registrado.

Estrutura

• src/index.js: boot da bot, conexao com Mongo/Redis, socket e eventos.
• src/events: eventos principais do WhatsApp e dispatcher de mensagens.
• src/commands: comandos carregados recursivamente.
• src/backend: painel web, auth, rotas e webhook de pagamento.
• src/database: models MongoDB e dados locais.
• src/lib: instancias externas como Mongo, Redis, Mercado Pago e Axios.
• src/utils: helpers compartilhados, cache, menu, TikTok, comandos e checks.
• src/api/tiktok-api: API local usada por comandos de TikTok.

Suporte

Contato

Grupo