zulip-hermes-integration
Plugin de Zulip para integrar al agente Hermes (Nous Research) como miembro del equipo en chats de streams y DMs. Solución auto-alojada, sin bloqueo de proveedores, con soporte para archivos, comandos administrativos y políticas de seguridad avanzadas.
Ficha actualizada 27 sept 2026, 17:41 · upstream 27 sept 2026, 17:36 · release v1.9.2
Qué es zulip-hermes-integration
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio contiene un plugin de Zulip diseñado para conectar el agente de inteligencia artificial Hermes (desarrollado por Nous Research) directamente en los chats de equipo. Permite que el bot actúe como un compañero completo en streams públicos y mensajes directos, manteniendo la conversación estructurada por temas. La integración es nativa con el ecosistema Zulip, ofreciendo una experiencia fluida donde los usuarios pueden interactuar con la IA sin salir del entorno de chat habitual.
La arquitectura se basa en un adaptador puro que no requiere modificaciones en el núcleo de Hermes, facilitando su despliegue como plugin. El sistema incluye mecanismos robustos para la gestión de sesiones por tema, limitación de velocidad para evitar inundaciones de mensajes y protección contra ataques comunes como SSRF o traversal de rutas. Además, proporciona herramientas para administradores para controlar quién puede interactuar con el bot mediante políticas de DM flexibles.
El plugin está escrito en Python y depende del SDK oficial de Zulip (versión >=0.9.0). Incluye un sistema de comandos integrados que permiten al usuario obtener información sobre el estado del bot, listar streams o gestionar mensajes sin necesidad de llamar a la LLM. La solución es compatible con versiones recientes de Hermes (>= 0.21.3) para aprovechar funcionalidades nativas de aprobación de ejecución.
- Integrar un agente de IA en chats corporativos de Zulip para asistencia técnica o soporte interno sin migrar a plataformas cerradas.
- Permitir que usuarios envíen archivos (CSV, JSON, PDF) al bot para análisis y procesamiento automático dentro del hilo de conversación.
- Implementar políticas estrictas de seguridad para mensajes directos con IA, incluyendo modos de emparejamiento y listas blancas de usuarios.
- Utilizar comandos administrativos predefinidos (/status, /help, /pin) para gestionar el bot sin intervención manual constante.
- Monitorear la salud del agente mediante endpoints de diagnóstico y logs de auditoría persistentes en formato JSON-line.
- Arquitectura de plugin puro que no modifica el núcleo de Hermes, permitiendo un despliegue modular y seguro.
- Soporte nativo para gestión de sesiones por tema (topic threading) y placeholders visuales durante la generación de respuestas.
- Mecanismos avanzados de seguridad: validación SSRF, rechazo de enlaces simbólicos y bloqueo de traversal de rutas.
- Sistema de limitación de velocidad (rate limiting) configurable por remitente para prevenir inundaciones de mensajes.
- Comandos administrativos integrados que responden instantáneamente sin consumir llamadas a la LLM.
- Compatibilidad con botones nativos de aprobación en Hermes >= 0.21.3 para gestión segura de ejecuciones.
- Requiere instalación manual del SDK de Zulip (pip install zulip>=0.9.0) en el entorno Python de Hermes, no es automático.
- No incluye Dockerfile ni archivos Compose; el despliegue depende de la configuración manual del entorno y variables de entorno.
- Las funcionalidades de aprobación nativa con botones no están disponibles en versiones de Hermes anteriores a 0.21.3.
- El plugin asume que Hermes está ya instalado y configurado; no es un agente independiente autocontenido.
- La detección de menciones depende de la configuración del servidor Zulip y puede requerir ajustes si se usan formatos de mención personalizados.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instalar el SDK de Zulip en el entorno Python de Hermes. Clonar el repositorio en ~/.hermes/plugins/zulip y habilitar el plugin con 'hermes plugins enable zulip'. Configurar variables de entorno ZULIP_API_KEY, ZULIP_EMAIL y ZULIP_SITE en ~/.hermes/.env. Activar el gateway con 'hermes gateway' y verificar la suscripción del bot a los streams deseados.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.