Repolode
Enviar
imkofty

imkofty/Hermuse

Scripts y guías para ejecutar Hermes Agent, el proxy de modelos 9Router y una pasarela de bot de Telegram en tu propio servidor Linux o VM.

Ver en GitHub
Estrellas
157
Forks
39
Issues abiertos
0
Último commit
hace 16 días

¿Qué es?

Hermuse es un conjunto de scripts de shell y documentación para ejecutar un stack personal de agente de IA en tu propia máquina o en un VPS. Combina la CLI de Hermes Agent, el proxy de modelos compatible con OpenAI 9Router y una pasarela de Telegram, para que puedas chatear con tu propio bot de IA las 24 horas y abrir un panel de modelos desde cualquier navegador.

El repositorio incluye instrucciones de instalación en Ubuntu, un túnel de Cloudflare que expone el panel local mediante Cloudflare Pages y D1 usando un cliente de sondeo, y supervisores que reinician 9Router, el cliente del túnel y la pasarela cuando fallan. Un script de watchdog se ejecuta desde cron, y otro watchdog independiente para la pasarela detecta si el sondeo de Telegram se ha bloqueado, en lugar de limitarse a comprobar que el proceso sigue activo.

El proyecto está pensado para VM con Linux e incluye un script de diagnóstico, un modelo de control de acceso basado en listas de permitidos para el bot de Telegram y guías para rotar credenciales y migrar la base de datos del túnel.

Funciones clave

  • 01Instala Hermes Agent, 9Router y Node.js en Ubuntu con un solo script.
  • 02Conecta un bot de Telegram a la pasarela de Hermes mediante una lista de permitidos basada en ID numéricos de usuario.
  • 03Expone públicamente el panel local de 9Router mediante un túnel de sondeo con Cloudflare Pages y D1.
  • 04Reinicia automáticamente 9Router, el cliente del túnel y la pasarela mediante scripts supervisores y watchdogs de cron.
  • 05Detecta bloqueos del sondeo de Telegram mediante un heartbeat del bucle de eventos y la actividad del adaptador.
  • 06Incluye un script de diagnóstico y un verificador de migraciones para la base de datos del túnel.

Casos de uso

  • Ejecutar un asistente privado de IA en Telegram en un VPS Linux pequeño.
  • Alojar un panel de modelos autogestionado al que se pueda acceder desde un navegador sin abrir puertos de entrada.
  • Operar un bot siempre activo que necesite recuperarse automáticamente tras fallos o reinicios.

Inicio rápido

  1. 1

    Instalar todo (dependencias, Hermes y 9Router)

    bash scripts/install.sh
  2. 2

    Iniciar sesión en el proveedor del modelo mediante OAuth

    hermes setup --portal
  3. 3

    Conectar el bot de Telegram y configurar la lista de permitidos de ID numéricos

    hermes gateway setup
  4. 4

    Instalar el túnel de Cloudflare (sustituir los marcadores de posición por los nombres del proyecto y de D1)

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

Antes de usarlo

  • Diseñado para un servidor Linux o una máquina virtual; el README no incluye instrucciones de configuración para macOS ni Windows.
  • El script de instalación requiere sudo sin contraseña o acceso root.
  • Para usar todas las funciones, se necesita una cuenta de Cloudflare y un token de bot de Telegram.

En colecciones

Frameworks y apps de agentes de IA open sourceApps autoalojadasChatbots de IA y clientes de chatAgentes personales de IA open source

Temas

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

Preguntas frecuentes

¿Qué es Hermuse?
Scripts y guías para ejecutar Hermes Agent, el proxy de modelos 9Router y una pasarela de bot de Telegram en tu propio servidor Linux o VM. Hermuse es un conjunto de scripts de shell y documentación para ejecutar un stack personal de agente de IA en tu propia máquina o en un VPS. Combina la CLI de Hermes Agent, el proxy de modelos compatible con OpenAI 9Router y una pasarela de Telegram, para que puedas chatear con tu propio bot de IA las 24 horas y abrir un panel de modelos desde cualquier navegador.
¿Hermuse es gratuito? ¿Qué licencia tiene?
Hermuse es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿Hermuse sigue mantenido?
Mantenimiento activo. El último commit de Hermuse fue el 23 oct 2026.
¿Para qué puedo usar Hermuse?
Ejecutar un asistente privado de IA en Telegram en un VPS Linux pequeño. Alojar un panel de modelos autogestionado al que se pueda acceder desde un navegador sin abrir puertos de entrada. Operar un bot siempre activo que necesite recuperarse automáticamente tras fallos o reinicios.
¿Cómo se instala Hermuse?
Instalar todo (dependencias, Hermes y 9Router): bash scripts/install.sh Iniciar sesión en el proveedor del modelo mediante OAuth: hermes setup --portal Conectar el bot de Telegram y configurar la lista de permitidos de ID numéricos: hermes gateway setup Instalar el túnel de Cloudflare (sustituir los marcadores de posición por los nombres del proyecto y de D1): bash scripts/setup-tunnel.sh <pages-project-name> <d1-name>
¿Dónde consigo Hermuse?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/imkofty/Hermuse

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

Proyectos relacionados