Un bot de Discord simple pero potente, powered by Google Gemini AI. Fácil de configurar y desplegar, perfecto para principiantes y desarrolladores experimentados.
- 🧠 IA Potente: Integración con Google Gemini 2.0 Flash
- ⚡ Dos Modos de Respuesta: Completas (
/ask
) y rápidas (/quick
) - 💬 Comandos Slash: Interfaz moderna y intuitiva
- 📏 Auto-división: Maneja respuestas largas automáticamente
- 🌐 Hosting Gratis: Despliegue fácil en Railway
- 📊 Tracking: Estadísticas de uso con
/stats
- 🔧 Código Simple: Fácil de entender y modificar
git clone https://github.com/andresjmorosa/simple-discord-bot.git
cd simple-discord-bot
pip install -r requirements.txt
Crea un archivo .env
:
DISCORD_TOKEN=tu_token_aqui
GEMINI_API_KEY=tu_gemini_key_aqui
python bot_gemini.py
- Ve a Discord Developers
- Crea New Application → Bot → Copy Token
- Activa Message Content Intent (importantísimo)
- Visita Google AI Studio
- Get API Key → Create API Key
- Copia tu clave
- Haz click en el botón de arriba
- Conecta tu GitHub
- Configura las variables:
DISCORD_TOKEN
= tu_token_discordGEMINI_API_KEY
= tu_api_key_gemini
- ¡Listo! Tu bot estará online 24/7
Comando | Descripción | Uso |
---|---|---|
/ask [pregunta] |
Respuesta completa (puede ser larga) | /ask pregunta: Explícame la teoría de la relatividad |
/quick [pregunta] |
⚡ Respuesta rápida (siempre en 1 mensaje) | /quick pregunta: ¿Qué es Python? |
/stats |
Ver estadísticas de uso | /stats |
/clear |
Limpiar historial de conversación | /clear |
/ask
: Para respuestas detalladas y explicaciones completas/quick
: Para respuestas concisas, definiciones rápidas y resúmenes
simple-discord-bot/
├── 📄 bot_gemini.py # Código principal (menos de 200 líneas)
├── 📄 requirements.txt # Dependencias (solo 3 paquetes)
├── 📄 Procfile # Configuración para Railway
├── 📄 LICENSE # Licencia MIT
├── 📄 .env.example # Ejemplo de variables de entorno
└── 📄 README.md # Este archivo
bot = commands.Bot(command_prefix='!', intents=intents) # Cambia '!' por tu prefijo
self.model = genai.GenerativeModel('gemini-2.0-flash') # ⚡ Más rápido
self.model = genai.GenerativeModel('gemini-1.5-pro') # 🧠 Más potente
# En el comando quick:
respuesta_corta = ensure_short_response(respuesta, 1500) # Cambia 1500 por tu límite
¡Las contribuciones son bienvenidas! Para contribuir:
- Fork el proyecto
- Crea una feature branch:
git checkout -b feature/nueva-feature
- Commit tus cambios:
git commit -m 'Agrega nueva feature'
- Push a la rama:
git push origin feature/nueva-feature
- Abre un Pull Request
Este proyecto está bajo la Licencia MIT. Ver el archivo LICENSE para más detalles.
✅ Sí! Discord + Gemini + Railway = 100% gratis para uso personal
✅ No! Solo sigue los pasos de instalación paso a paso
✅ Sí! Discord móvil soporta comandos slash perfectamente
🔷 Gemini tiene límites generosos en su plan gratuito
🔷 Sí, durante la misma sesión. Usa /clear
para reiniciar
- ❌ Bot no responde: Verifica que activaste "Message Content Intent"
- ❌ Error de conexión: Revisa que las API keys sean correctas
- ❌ Comandos no aparecen: Espera hasta 1 hora para que se propaguen
- Revisa los Issues
- Crea un nuevo issue con detalles de tu problema
- Error común: No activar "Message Content Intent" en Discord
⭐ ¿Te gustó el bot? ¡Dale una estrella al repositorio!
🎯 Perfecto para:
- Servidores de amigos y comunidades
- Aprendizaje y educación
- Proyectos de programación
- Primer bot de Discord
- Experimentar con IA conversacional
¡Disfruta de tu nuevo bot inteligente! 😊🚀