Pedro-bot
Bot Discord auto-alojado en Python 3.13 con discord.py, FastAPI y htmx. Incluye reproductor de música vía Lavalink, lobbies de voz temporales, generación de GIFs, autoroles, mensajes de bienvenida y dashboard web para monitorización y gestión de cogs sin reinicio.
Ficha actualizada 27 sept 2026, 23:12 · upstream 27 sept 2026, 22:39 · release sin release detectada
Qué es Pedro-bot
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Pedro-bot es un bot Discord auto-alojado construido sobre discord.py con una arquitectura modular basada en cogs descubiertos automáticamente desde el directorio cogs/. Incluye un dashboard web desarrollado con FastAPI y htmx que permite monitorización en tiempo real, gestión de cogs (cargar/descargar/recargar), sincronización de comandos slash y visualización del console interno sin reiniciar el servicio principal.
El bot ofrece funcionalidades de entretenimiento como lobbies de voz temporales que se auto-limpian cuando están vacíos, reproductor de música con cola desde YouTube, YouTube Music, SoundCloud y Bandcamp mediante un nodo Lavalink auto-alojado (requiere JDK 17+), generación de GIFs con 25 efectos aplicados a avatares o URLs vía API externa Jeyy, autoroles automáticos para nuevos miembros y mensajes de bienvenida configurables por canal.
La arquitectura incluye logging detallado de todos los comandos slash ejecutados (usuario invocador, opciones y canal) hacia un canal configurable, personalización de servidores con colores de embeds por guild y reglas del servidor. El dashboard se sirve desde el supervisor para mantenerse activo incluso si el bot falla. Requiere Python 3.13, token de Discord en .env y JDK 17+ exclusivamente para funcionalidades musicales.
- Gestión de comunidades Discord con monitorización centralizada vía dashboard web
- Reproductor de música multiplataforma para eventos en voz temporal sin configurar canales permanentes
- Automatización de bienvenida y asignación de roles para nuevos miembros
- Generación de contenido visual (GIFs) integrando API externas sin dependencias locales
- Dashboard web independiente servido por supervisor, sobrevive a fallos del bot principal
- Sistema de cogs auto-descubiertos permite hot-reload sin reinicio del servicio
- Reproductor Lavalink con soporte multiplataforma (YouTube, SoundCloud, Bandcamp)
- Lobby de voz temporal con limpieza automática al vaciarse
- Logging exhaustivo de comandos slash con contexto completo de invocación
- No incluye Dockerfile ni compose nativo; requiere despliegue manual en Python 3.13
- Funcionalidad musical depende de JDK 17+ externo no incluido en requirements.txt
- Generación de GIFs depende de API externa Jeyy (no control total sobre la fuente)
- Requiere configuración manual de .env con token de Discord y variables adicionales
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliegue manual: clonar repositorio, instalar dependencias con pip en Python 3.13, configurar .env con token de Discord y JDK 17+ para música. Ejecutar scripts/setup_lavalink.py opcionalmente antes de iniciar con run.py. El dashboard se sirve desde el supervisor del proceso principal. Verificar permisos de intents en la aplicación Discord antes de activar el bot.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.