Repolode
Enviar
Higangssh

Higangssh/homebutler

Un único binario de Go que recuerda el último estado de tu servidor e informa solo de los cambios que vale la pena notar, con un servidor MCP integrado.

Ver en GitHubSitio web
Estrellas
314
Forks
22
Issues abiertos
7
Último commit
hace 7 días

¿Qué es?

HomeButler es una herramienta de operaciones para homelabs en servidores Linux y macOS. Su comando `report` guarda una captura del estado de los contenedores, los puertos y el uso del disco; después compara cada ejecución con la captura anterior y enumera solo los cambios, como un contenedor que se volvió a crear con el mismo nombre, un puerto que pasó a estar ocupado por otro proceso o una comparación que no se pudo realizar. Cada cambio incluye una palabra fija que indica su tipo, también presente en la salida JSON para que los scripts y los agentes puedan tomar decisiones en función de ella.

El proyecto abarca varias áreas: `doctor` ejecuta comprobaciones preliminares de solo lectura para detectar presión sobre el disco y la memoria, contenedores detenidos, puertos públicos y copias de seguridad faltantes; `watch` detecta reinicios de contenedores, systemd y PM2, guarda los logs previos a cada fallo y señala los ciclos de reinicio; `backup drill` inicia un archivo de copia de seguridad en un contenedor aislado y exige que supere una comprobación de estado HTTP. También instala un conjunto de aplicaciones autoalojadas mediante docker compose y puede administrar endpoints de Proxmox VE a través de su API.

HomeButler es un único binario, no requiere una base de datos ni un agente residente en las máquinas que supervisa; se conecta por SSH cuando se le solicita. Ofrece una CLI, un panel web, un panel para la terminal y un servidor MCP para que los agentes de IA consulten el servidor sin iniciar una sesión de shell completa.

Funciones clave

  • 01`report` basado en capturas de estado que enumera solo los cambios desde la última ejecución y ofrece salida JSON
  • 02Comprobaciones de solo lectura con `doctor` para detectar presión sobre los recursos, puertos expuestos y problemas con las copias de seguridad
  • 03Detección de reinicios de Docker, systemd y PM2, con logs guardados y alertas de reinicios repetidos
  • 04`backup drill` inicia archivos de copia de seguridad en contenedores aislados y comprueba el estado HTTP
  • 05Instalación de aplicaciones autoalojadas con un solo comando mediante docker compose
  • 06Servidor MCP, panel web y panel para la terminal integrados

Casos de uso

  • Comprobar qué cambió en un servidor doméstico después de una actualización o un reinicio
  • Verificar que las copias de seguridad realmente se pueden restaurar antes de necesitarlas
  • Permitir que un asistente de IA inspeccione el estado del servidor sin darle acceso a una shell SSH
  • Supervisar reinicios de contenedores y ciclos de fallos en un host Linux pequeño o una Raspberry Pi

Inicio rápido

  1. 1

    Instalar con Homebrew

    brew install Higangssh/homebutler/homebutler
  2. 2

    Ejecutar la configuración interactiva para añadir los servidores

    homebutler init
  3. 3

    Comprobar el estado actual de los servidores

    homebutler status
  4. 4

    Generar un informe de estado y cambios

    homebutler report

Antes de usarlo

  • Se requiere Go 1.25 o posterior para compilar desde el código fuente.
  • La supervisión y los informes dependen de que Docker, systemd o PM2 estén disponibles en las máquinas de destino.

En colecciones

Monitorización de disponibilidad y servidores autoalojadaServidores MCPApps autoalojadasHerramientas de CLI y terminal

Temas

#homelab#monitoring#docker#self-hosted#devops#mcp#backup#cli#ai#change-detection

Preguntas frecuentes

¿Qué es homebutler?
Un único binario de Go que recuerda el último estado de tu servidor e informa solo de los cambios que vale la pena notar, con un servidor MCP integrado. HomeButler es una herramienta de operaciones para homelabs en servidores Linux y macOS. Su comando `report` guarda una captura del estado de los contenedores, los puertos y el uso del disco; después compara cada ejecución con la captura anterior y enumera solo los cambios, como un contenedor que se volvió a crear con el mismo nombre, un puerto que pasó a estar ocupado por otro proceso o una comparación que no se pudo realizar. Cada cambio incluye una palabra fija que indica su tipo, también presente en la salida JSON para que los scripts y los agentes puedan tomar decisiones en función de ella.
¿homebutler es gratuito? ¿Qué licencia tiene?
homebutler es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿homebutler sigue mantenido?
Mantenimiento activo. El último commit de homebutler fue el 1 nov 2026.
¿Para qué puedo usar homebutler?
Comprobar qué cambió en un servidor doméstico después de una actualización o un reinicio Verificar que las copias de seguridad realmente se pueden restaurar antes de necesitarlas Permitir que un asistente de IA inspeccione el estado del servidor sin darle acceso a una shell SSH Supervisar reinicios de contenedores y ciclos de fallos en un host Linux pequeño o una Raspberry Pi
¿Cómo se instala homebutler?
Instalar con Homebrew: brew install Higangssh/homebutler/homebutler Ejecutar la configuración interactiva para añadir los servidores: homebutler init Comprobar el estado actual de los servidores: homebutler status Generar un informe de estado y cambios: homebutler report
¿Dónde consigo homebutler?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Higangssh/homebutler

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados

databasus / databasus

Herramienta gratuita y autoalojada para hacer copias de seguridad de PostgreSQL, con recuperación a un punto en el tiempo, verificación automatizada de restauraciones e interfaz web.

DevOps y nube#backup#postgresql#database-backup
9,2 mil+26 esta semana605TypeScriptApache-2.0Bien mantenidoActualizado ayer