Repolode
Enviar
imkofty

imkofty/Hermuse

Scripts e guias para executar o Hermes Agent, o proxy de modelos 9Router e um gateway de bot do Telegram no seu próprio servidor Linux ou VM.

Ver no GitHub
Estrelas
157
Forks
39
Issues abertas
0
Último commit
há 16 dias

O que é?

Hermuse é um conjunto de scripts de shell e documentação para executar uma estrutura pessoal de agente de IA na sua própria máquina ou VPS. Ele combina a CLI do Hermes Agent, o proxy de modelos compatível com OpenAI 9Router e um gateway do Telegram, para que você possa conversar com seu próprio bot de IA 24 horas por dia e acessar um painel de modelos em qualquer navegador.

O repositório cobre a instalação no Ubuntu, um túnel do Cloudflare que expõe o painel local por meio do Cloudflare Pages e do D1 usando um cliente de polling, além de supervisores que reiniciam o 9Router, o cliente do túnel e o gateway quando falham. Um script watchdog é executado pelo cron, e um watchdog separado para o gateway detecta quando o polling do Telegram trava, em vez de apenas verificar se o processo está ativo.

O projeto é voltado para VMs Linux e inclui um script doctor, um modelo de controle de acesso por allowlist para o bot do Telegram e guias para rotação de credenciais e migrações do banco de dados do túnel.

Recursos principais

  • 01Instala o Hermes Agent, o 9Router e o Node.js no Ubuntu com um único script.
  • 02Conecta um bot do Telegram ao gateway do Hermes usando uma allowlist de IDs numéricos de usuário.
  • 03Expõe publicamente o painel local do 9Router por meio de um túnel de polling com Cloudflare Pages e D1.
  • 04Reinicia automaticamente o 9Router, o cliente do túnel e o gateway por meio de scripts supervisores e watchdogs do cron.
  • 05Detecta quando o polling do Telegram trava usando um heartbeat do event loop e a atividade do adaptador.
  • 06Fornece um script doctor e um verificador de migrações para o banco de dados do túnel.

Casos de uso

  • Executar um assistente privado de IA no Telegram em uma VPS Linux pequena.
  • Hospedar um painel de modelos autogerenciado, acessível pelo navegador sem abrir portas de entrada.
  • Operar um bot sempre ativo que precisa se recuperar automaticamente após falhas ou reinicializações.

Início rápido

  1. 1

    Instalar tudo (dependências, Hermes e 9Router)

    bash scripts/install.sh
  2. 2

    Fazer login no provedor do modelo via OAuth

    hermes setup --portal
  3. 3

    Conectar o bot do Telegram e configurar a lista de permissões de IDs numéricos

    hermes gateway setup
  4. 4

    Instalar o túnel do Cloudflare (substitua os marcadores pelos nomes do projeto e do D1)

    bash scripts/setup-tunnel.sh <pages-project-name> <d1-name>

Antes de usar

  • Projetado para um servidor Linux ou uma VM; o README não inclui instruções de configuração para macOS ou Windows.
  • O script de instalação requer sudo sem senha ou acesso root.
  • Para usar todos os recursos, é necessário ter uma conta do Cloudflare e um token de bot do Telegram.

Em coleções

Frameworks e apps de agentes de IA open sourceApps auto-hospedadosChatbots de IA e clientes de chatAgentes pessoais de IA open source

Tópicos

#ai-agent#telegram-bot#self-hosted#cloudflare#llm#automation#openai-compatible#chatbot#hermes-agent#personal-assistant

Perguntas frequentes

O que é Hermuse?
Scripts e guias para executar o Hermes Agent, o proxy de modelos 9Router e um gateway de bot do Telegram no seu próprio servidor Linux ou VM. Hermuse é um conjunto de scripts de shell e documentação para executar uma estrutura pessoal de agente de IA na sua própria máquina ou VPS. Ele combina a CLI do Hermes Agent, o proxy de modelos compatível com OpenAI 9Router e um gateway do Telegram, para que você possa conversar com seu próprio bot de IA 24 horas por dia e acessar um painel de modelos em qualquer navegador.
Hermuse é gratuito? Qual é a licença?
Hermuse é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
Hermuse ainda é mantido?
Manutenção ativa. O último commit de Hermuse foi em 23 de out. de 2026.
Para que posso usar Hermuse?
Executar um assistente privado de IA no Telegram em uma VPS Linux pequena. Hospedar um painel de modelos autogerenciado, acessível pelo navegador sem abrir portas de entrada. Operar um bot sempre ativo que precisa se recuperar automaticamente após falhas ou reinicializações.
Como instalar Hermuse?
Instalar tudo (dependências, Hermes e 9Router): bash scripts/install.sh Fazer login no provedor do modelo via OAuth: hermes setup --portal Conectar o bot do Telegram e configurar a lista de permissões de IDs numéricos: hermes gateway setup Instalar o túnel do Cloudflare (substitua os marcadores pelos nomes do projeto e do D1): bash scripts/setup-tunnel.sh <pages-project-name> <d1-name>
Onde consigo Hermuse?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/imkofty/Hermuse

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

Projetos relacionados