bot-manager
Bot-manager es una herramienta para gestionar hasta tres bots de Telegram como procesos hijos desde un único bot padre. Permite desplegar, supervisar y eliminar bots hijos subiendo código comprimido directamente desde el chat, ejecutándose nativamente en Railway sin contenedores Docker.
Ficha actualizada 27 sept 2026, 18:41 · upstream 27 sept 2026, 18:27 · release v1.0.0
Qué es bot-manager
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este proyecto facilita la gestión centralizada de múltiples bots de Telegram en una sola instancia de servidor, ideal para entornos de desarrollo o hosting ligero. El bot padre actúa como supervisor, permitiendo desplegar nuevos bots hijos mediante un asistente en el chat que acepta archivos ZIP con código Python, Node.js o scripts personalizados.
La arquitectura se basa en procesos hijos aislados, cada uno con su propio entorno virtual, directorio de logs y configuración específica. El sistema garantiza la supervisión continua, enviando notificaciones al usuario cuando un bot hijo falla inesperadamente y proporcionando acceso a los últimos registros para diagnóstico. La persistencia del estado y los datos de los bots se maneja mediante volúmenes externos en plataformas como Railway.
Aunque no utiliza Docker ni contenedores, ofrece una abstracción de procesos robusta que permite reinicios limpios y recuperación automática tras fallos del supervisor. Es una solución ligera para pruebas o despliegues pequeños donde la complejidad de orquestación completa no es necesaria.
- Pruebas rápidas de múltiples bots en un mismo entorno sin necesidad de instancias separadas.
- Gestión centralizada de bots pequeños con requisitos de recursos limitados.
- Despliegue ágil de bots personalizados desde el chat usando archivos ZIP.
- Supervisión y recuperación automática de procesos hijos tras fallos inesperados.
- Permite desplegar hasta tres bots hijos con aislamiento de entorno (venv, node_modules, logs).
- Notificaciones inmediatas vía Telegram cuando un bot hijo se detiene anormalmente.
- Persistencia de estado y datos garantizada mediante volúmenes externos en Railway.
- Soporte nativo para Python, Node.js y comandos personalizados sin contenedores Docker.
- No utiliza Docker ni contenedores, lo que implica ejecutar procesos directamente en el sistema operativo del servidor.
- Limitado a un máximo de tres bots desplegados y tres ejecutándose simultáneamente por defecto.
- No ofrece sandboxing; los bots hijos comparten el mismo usuario y permisos de archivo que el supervisor.
- La persistencia depende críticamente de configurar volúmenes externos para evitar pérdida de datos al redeplegar.
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.
Para Railway, configura variables de entorno TELEGRAM_BOT_TOKEN y ADMIN_IDS. Asegura un volumen montado en /data para persistencia; sin él, cada despliegue reinicia todo el estado. En local, usa Python 3.11/3.12 con venv y edita .env antes de ejecutar main.py. Considera añadir NIXPACKS_PKGS=nodejs_20 si planeas alojar bots en Node.js.
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.