Repolode
Enviar
Higangssh

Higangssh/homebutler

Um único binário Go que guarda o último estado do servidor e informa apenas as mudanças relevantes, com um servidor MCP integrado.

Ver no GitHubSite
Estrelas
314
Forks
22
Issues abertas
7
Último commit
há 5 dias

O que é?

O HomeButler é uma ferramenta de operações de homelab para servidores Linux e macOS. O comando `report` salva um snapshot de contêineres, portas e uso de disco, compara cada execução com o snapshot anterior e lista apenas o que mudou — por exemplo, um contêiner recriado com o mesmo nome, uma porta ocupada por outro processo ou uma comparação que não pôde ser feita. Cada mudança recebe uma palavra fixa que indica seu tipo, também presente na saída JSON para que scripts e agentes possam tomar decisões com base nela.

O projeto cobre várias áreas: `doctor` executa verificações preliminares somente de leitura para identificar pressão sobre disco e memória, contêineres parados, portas públicas e backups ausentes; `watch` detecta reinicializações de contêineres, systemd e PM2, salva logs em torno de cada falha e sinaliza ciclos de reinicialização; `backup drill` inicia um arquivo de backup em um contêiner isolado e exige que uma verificação de integridade HTTP seja aprovada. Ele também instala um conjunto de apps self-hosted usando docker compose e pode gerenciar endpoints do Proxmox VE pela API.

O HomeButler é um único binário, sem banco de dados nem agente residente nas máquinas monitoradas; ele se conecta por SSH quando solicitado. Oferece uma CLI, um dashboard web, um dashboard no terminal e um servidor MCP para que agentes de IA consultem o servidor sem precisar de uma sessão completa de shell.

Recursos principais

  • 01`report` baseado em snapshots que lista apenas as mudanças desde a última execução, com saída JSON
  • 02Verificações `doctor` somente de leitura para pressão sobre recursos, portas expostas e boas práticas de backup
  • 03Detecção de reinicializações de Docker, systemd e PM2, com logs salvos e alertas de reinicializações recorrentes
  • 04`backup drill` inicia arquivos de backup em contêineres isolados e verifica a integridade HTTP
  • 05Instalação de apps self-hosted com um único comando, usando docker compose
  • 06Servidor MCP integrado, dashboard web e dashboard no terminal

Casos de uso

  • Verificar o que mudou em um servidor doméstico depois de uma atualização ou reinicialização
  • Confirmar que os backups podem ser restaurados de fato antes de precisar deles
  • Permitir que um assistente de IA inspecione o estado do servidor sem conceder acesso ao shell via SSH
  • Monitorar reinicializações de contêineres e ciclos de falhas em um host pequeno com Linux ou Raspberry Pi

Início rápido

  1. 1

    Instalar com Homebrew

    brew install Higangssh/homebutler/homebutler
  2. 2

    Executar a configuração interativa para adicionar os servidores

    homebutler init
  3. 3

    Verificar o status atual dos servidores

    homebutler status
  4. 4

    Gerar um relatório de integridade e alterações

    homebutler report

Antes de usar

  • É necessário ter Go 1.25 ou posterior para compilar a partir do código-fonte.
  • O monitoramento e os relatórios dependem da disponibilidade de Docker, systemd ou PM2 nas máquinas de destino.

Em coleções

Monitoramento de disponibilidade e servidores auto-hospedadoServidores MCPApps auto-hospedadosFerramentas de CLI e terminal

Tópicos

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

Perguntas frequentes

O que é homebutler?
Um único binário Go que guarda o último estado do servidor e informa apenas as mudanças relevantes, com um servidor MCP integrado. O HomeButler é uma ferramenta de operações de homelab para servidores Linux e macOS. O comando `report` salva um snapshot de contêineres, portas e uso de disco, compara cada execução com o snapshot anterior e lista apenas o que mudou — por exemplo, um contêiner recriado com o mesmo nome, uma porta ocupada por outro processo ou uma comparação que não pôde ser feita. Cada mudança recebe uma palavra fixa que indica seu tipo, também presente na saída JSON para que scripts e agentes possam tomar decisões com base nela.
homebutler é gratuito? Qual é a licença?
homebutler é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
homebutler ainda é mantido?
Manutenção ativa. O último commit de homebutler foi em 1 de nov. de 2026.
Para que posso usar homebutler?
Verificar o que mudou em um servidor doméstico depois de uma atualização ou reinicialização Confirmar que os backups podem ser restaurados de fato antes de precisar deles Permitir que um assistente de IA inspecione o estado do servidor sem conceder acesso ao shell via SSH Monitorar reinicializações de contêineres e ciclos de falhas em um host pequeno com Linux ou Raspberry Pi
Como instalar homebutler?
Instalar com Homebrew: brew install Higangssh/homebutler/homebutler Executar a configuração interativa para adicionar os servidores: homebutler init Verificar o status atual dos servidores: homebutler status Gerar um relatório de integridade e alterações: homebutler report
Onde consigo homebutler?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Higangssh/homebutler

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados