Homelab Bot

🚀 Descripción

Bot de Telegram modular para gestión de Homelab, Docker, Energía, Domótica y Seguridad.

✨ Características

• 🛡️ Seguridad: Escaneo de red, logs, threat intel
• 🐳 Docker: Control de contenedores, healthchecks, rollback
• 🌐 Red: Mapa de red, latencia, anomalías
• ⚡ Energía: Consumo, solar, costes
• 🏠 Domótica: Home Assistant integration
• 🤖 Automatización: Motor de reglas, perfiles
• ⚙️ Admin: Usuarios, plugins, idiomas

🌍 Idiomas

• Español
• Català
• English

🐳 Docker

# Clonar repositorio
git clone https://github.com/tu-usuario/homelab-bot.git
cd homelab-bot

# Configurar
cp .env.example .env
nano .env  # Añadir tu TELEGRAM_TOKEN

# Ejecutar
docker-compose up -d

# Ver logs
docker-compose logs -f

💻 Desarrollo Local

# Instalar dependencias
pip install -r requirements.txt

# Configurar
cp .env.example .env

# Ejecutar
python main.py

🔌 Añadir Módulos

1. Crear carpeta modules/mi_modulo/
2. Crear mi_modulo_module.py con clase que hereda de BaseModule
3. Opcional: Crear module.json con metadata
4. Reiniciar el bot

📁 Estructura

├── core/               # Núcleo del bot
│   ├── config.py       # Configuración SQLite
│   ├── plugin_manager.py # Carga dinámica de módulos
│   └── base_module.py  # Clase base para módulos
├── modules/            # Módulos del bot
│   ├── security/
│   ├── docker/
│   ├── network/
│   ├── energy/
│   ├── hass/
│   ├── automation/
│   └── admin/
├── locales/            # Traducciones
│   ├── es.py
│   ├── ca.py
│   └── en.py
├── data/               # Datos persistentes
├── Dockerfile
├── docker-compose.yml
└── main.py

📜 Licencia

MIT