A feature-rich Discord bot with multi-provider AI, personality customization, 100+ slash commands, moderation, and more.
Instalação · Configuração · Comandos · IA · Contribuir
Miku Bot é um bot Discord completo, open source, desenvolvido com discord.js v14. Ele conta com integração de múltiplos provedores de IA (Gemini, Claude e GPT), personalidade customizável, sistema de moderação robusto, comandos de interação com GIFs e muito mais.
⚠️ Nota de segurança: Este projeto utilizaaxios@1.14.0(versão segura). As versões1.14.1e0.30.4do axios foram comprometidas em um supply chain attack em Março de 2026 — veja SECURITY.md para mais detalhes.
- 3 provedores: Google Gemini · Anthropic Claude · OpenAI GPT
- Fallback automático: se um provedor falhar, o próximo é usado
- Personalidade customizável via
/personalityou variável de ambiente - Histórico por canal com limite configurável
- Reconhece o dono com tratamento especial
@Miku oi!
> Oiê! 💕 Tudo bem?
@Miku me explica como funciona uma API
> Uma API é basicamente um contrato entre sistemas...
Configure a ordem dos provedores via
AI_PRIORITY=gemini,anthropic,openai
- Node.js >= 18
- Uma aplicação criada no Discord Developer Portal
- Pelo menos uma API key de IA (Gemini é gratuito)
# 1. Clone o repositório
git clone https://github.com/snwvlr/miku-bot.git
cd miku-bot/discord-bot
# 2. Instale as dependências
npm install
# 3. Configure o ambiente
cp .env.example .env
# Edite o .env com suas chaves
# 4. Registre os slash commands
npm run deploy
# 5. Inicie o bot
npm startCopie .env.example para .env e preencha os valores. Exemplo mínimo:
# Discord (obrigatório)
DISCORD_TOKEN=seu_token
CLIENT_ID=seu_client_id
GUILD_ID=seu_guild_id
OWNER_ID=seu_user_id
# IA — configure pelo menos uma
GEMINI_API_KEY= # gratuito em aistudio.google.com
ANTHROPIC_API_KEY= # console.anthropic.com
OPENAI_API_KEY= # platform.openai.comVeja o arquivo .env.example para todas as opções disponíveis.
| Categoria | Qtd | Exemplos |
|---|---|---|
| 🎭 Interação | 45 | hug kiss pat slap bonk dance cuddle bite |
| 🎮 Diversão | 16 | waifu neko 8ball ship roll coinflip joke |
| 🛡️ Moderação | 13 | ban kick clear timeout warn lock softban |
| 🔧 Utilidade | 7 | ping avatar userinfo serverinfo emoji |
| ⚙️ Config | 2 | welcome autorole |
| ℹ️ Info | 2 | about invite |
| 👑 Owner | 6 | personality broadcast status reload |
| Total Slash | 91 | |
| 🖱️ Context Menus | 9 | Deletar · Fixar · Citar · Banir · Silenciar · Traduzir |
| Total Geral | 100+ |
miku-bot/
├── discord-bot/ # código principal
│ ├── src/
│ │ ├── commands/
│ │ │ ├── slash/ # comandos slash por categoria
│ │ │ └── context/ # menus de contexto
│ │ ├── events/ # ready, interactionCreate, messageCreate, guildMemberAdd
│ │ ├── handlers/ # carregamento automático de comandos e eventos
│ │ ├── services/
│ │ │ ├── aiService.js # integração multi-provider de IA
│ │ │ └── nekosService.js # GIFs de interação
│ │ ├── utils/ # embed helper, logger
│ │ └── data/ # persistência local (welcome, autorole)
│ ├── .env.example
│ └── package.json
├── CONTRIBUTING.md
├── SECURITY.md
├── CODE_OF_CONDUCT.md
├── LICENSE
└── README.md
| Pacote | Versão | Uso |
|---|---|---|
| discord.js | v14 | Framework principal |
| @google/generative-ai | latest | Gemini AI |
| @anthropic-ai/sdk | latest | Claude AI |
| openai | latest | GPT |
| axios | 1.14.0 |
Requisições HTTP (ver SECURITY.md) |
| dotenv | latest | Variáveis de ambiente |
Contribuições são muito bem-vindas! Veja o guia completo em CONTRIBUTING.md.
Encontrou uma vulnerabilidade? Veja SECURITY.md para saber como reportar de forma responsável.
Distribuído sob a licença MIT. Veja LICENSE para mais informações.
Feito com 💕 e muito café ☕
Se o projeto te ajudou, considere apoiar:
