Hermes Agent & Hedonist Orchestrator

1. Visión general del concepto y problema sistémico

La mayoría de las ideas, enlaces para investigación y tareas operativas surgen para el desarrollador o fundador sobre la marcha — en su smartphone. Sin embargo, la infraestructura de trabajo (servidores, bases de código, notas locales de Obsidian, terminales) sigue atada a su laptop de trabajo:

1. Alto umbral para iniciar la rutina: Para iniciar el análisis de noticias o verificar el estado de un backup en el servidor, es necesario abrir la laptop, conectarse por SSH y ejecutar scripts manualmente.
2. Fragmentación del flujo de entrada: Los enlaces se pierden en "Guardados" en el mensajero sin análisis ni categorización.
3. Dependencia de soluciones SaaS ajenas: El uso de servicios comerciales no proporciona control total sobre las claves del sistema y los datos privados.

Hermes Agent & Hedonist Orchestrator crean un puente digital soberano: interactúas con tu infraestructura personal y modelos avanzados de inteligencia artificial a través de la interfaz familiar de Telegram tan naturalmente como lo harías con un colega en un chat.

2. Taxonomía arquitectónica y modelo mental

La arquitectura está construida sobre un principio modular con cuatro capas aisladas:

• 1. Gateway de autenticación y enrutamiento (Hedonist Gateway): Punto de entrada para eventos Webhook de Telegram. Realiza una estricta verificación de la lista blanca ALLOWED_TELEGRAM_USER_IDS y firmas criptográficas. Funciona como un despachador: analiza el texto/audio entrante a través de un modelo rápido (Gemini Flash o Claude Haiku) y determina el pipeline objetivo.
• 2. Núcleo de ejecución de agentes (Hermes Core): Trabajador autónomo que tiene acceso a herramientas: llamadas curl/bash, web scraping, interacción con repositorios Git y generación de código.
• 3. Capa de conocimiento y contexto a largo plazo (Knowledge Vault): Almacenamiento local de archivos Markdown (sincronizado con el almacenamiento personal de Obsidian), base de datos relacional SQLite y índices vectoriales para búsqueda semántica.
• 4. Subsistema de notificaciones y retroalimentación (Feedback Loop): Formateo de respuestas en limpio MarkdownV2 de Telegram con botones interactivos en línea para confirmar acciones críticas (Human-in-the-Loop).

3. Pipeline técnico y mecánica interna

El ciclo de vida de ejecución de un comando se desarrolla de la siguiente manera:

1. Ingress & Authentication (Ingreso y Autenticación): Telegram envía un payload JSON a un endpoint HTTPS protegido. Hedonist verifica el User ID. Si la solicitud proviene de un usuario no autorizado, se rechaza inmediatamente (Drop without response) para prevenir escaneos.
2. Intent Parsing & Context Fetching (Análisis de intención y obtención de contexto): El orquestador clasifica la tarea (por ejemplo: cmd:server_health, digest:url_scrape, note:create). Si es una investigación, se extraen notas relevantes y contexto de sesiones anteriores del Knowledge Vault.
3. Execution & Sandboxed Processing (Ejecución de la tarea): Hermes ejecuta el script correspondiente o forma una solicitud a LLM dentro de un contenedor Docker aislado. Las operaciones de larga duración se trasladan a modo asíncrono con el envío de estado typing o un mensaje intermedio.
4. Delivery & State Commit (Entrega y confirmación de estado): El usuario recibe una respuesta estructurada con puntos clave, y el artefacto creado (nota, informe o diff de código) se comitea automáticamente en el repositorio Git local.

4. Escenarios prácticos de ingeniería en producción

01. Móvil DevOps para el servidor 24/7

Recibes una notificación sobre un pico de carga en el VPS. Al enviar un breve mensaje al bot, obtienes la salida de docker stats, el estado de los servicios en tiempo real y un botón "Reiniciar Nginx", sin abrir la terminal.

02. Investigación profunda y preparación automática de resúmenes

Envías a un chat de Telegram un enlace a un PDF de 50 páginas o un artículo. Hermes Agent carga la página en modo headless, recorta contenido sin publicidad, sintetiza los principales insights arquitectónicos y los añade a la cola de publicaciones de tu canal o blog.

03. Sincronización bidireccional de pensamientos con Obsidian

Un mensaje de voz en movimiento se transcribe, se estructura en puntos clave mediante un modelo, se categoriza con etiquetas y se guarda como un nuevo archivo en la carpeta Daily Notes de tu repositorio personal con un git push automático.

5. Errores comunes, trampas y seguridad

• Riesgo de acceso no autorizado (Open Bot Risk): Si el bot no tiene una lista de ID permitidos estrictamente codificada en la primera línea del manejador, un usuario externo podría dar una orden para eliminar la base de datos.
• Bloqueo del Event Loop por largas solicitudes LLM: La espera sincrónica de una respuesta del modelo durante 30 segundos bloquea el procesamiento de mensajes de otros triggers o timeouts. Todas las interacciones deben ser estrictamente asíncronas (async/await o colas de tareas).
• Errores de análisis de Markdown de Telegram: Caracteres como _, *, [, ] en la salida de código a menudo rompen el renderizado del Telegram Bot API (error Bad Request: can't parse entities). Es necesario utilizar una función de saneamiento confiable o enviar código sin procesar en bloques pre.