Hermes OSINT v3.0 🏛️🧠
El Analista OSINT Agentic
Investigaciones impulsadas por IA conversacional. Lenguaje natural. Resultados expertos. 🤖✨

Novedades en v3.0 🎉️
Hermes 3.0 representa un cambio de paradigma completo: de la orquestación de herramientas basada en pipelines a una plataforma de investigación impulsada por IA conversacional. Impulsado por LLM locales a través de Ollama, Hermes ahora comprende consultas en lenguaje natural, selecciona y ejecuta herramientas de forma autónoma, y sintetiza los hallazgos en informes de inteligencia coherentes.
🧠 Inteligencia Agentica
- Interfaz de Lenguaje Natural - Haz preguntas como "Encuentra todo sobre @johndoe" en lugar de memorizar banderas de CLI
- Patrón ReAct - Ciclo Pensar → Actuar → Observar para investigaciones inteligentes e iterativas
- Selección Autónoma de Herramientas - El LLM decide qué herramientas ejecutar según el contexto
- Informes con Citas - Cada hallazgo se atribuye a su herramienta de origen
💬 TUI Interactiva
- REPL Conversacional - Chatea con Hermes en una interfaz de terminal con temática de pentesting
- Persistencia de Sesiones - Guarda y reanuda investigaciones con
/save y /load
- Gestión de Contexto - La resumición automática evita el desbordamiento de tokens en sesiones largas
- Barra de Estado en Tiempo Real - Modelo, uso de contexto y modo sigiloso de un vistazo
🔄 Modos de Ejecución Flexibles
- Modo TUI (predeterminado) - Experiencia conversacional completa con Ollama
- Modo Headless -
--headless --query "..." para scripting y automatización
- Modo Legado -
hermes sherlock <user> para acceso directo a herramientas sin LLM
Resumen 🎯
Hermes es una plataforma universal de orquestación OSINT que unifica las mejores herramientas de inteligencia de código abierto en un único flujo de trabajo impulsado por IA. En lugar de ejecutar Sherlock, TheHarvester, Holehe y otras herramientas por separado—desperdiciando un tiempo de investigación valioso ⏰—el núcleo agentico de Hermes entiende tu intención, orquesta las herramientas de forma inteligente, correlaciona resultados entre fuentes y genera informes profesionales. 📊
Qué hace diferente a Hermes: 🌟
- 🧠 IA Agentica con patrón ReAct: deja que el LLM dirija tu investigación
- 💬 Consultas en lenguaje natural—sin banderas que memorizar, solo describe lo que necesitas
- 🔒 Arquitectura de plugins security-first con análisis estático de código: la confianza se gana
- 🐳 Aislamiento con Docker para ejecución de herramientas de confianza cero: pon todo en la caja de arena
- ⚡ Procesamiento paralelo con gestión inteligente de recursos: 2x más rápido que el secuencial
- 🧩 Motor de correlación entre herramientas para mapeo de relaciones: conecta los puntos automáticamente
- 🔧 Diseño extensible—añade nuevas herramientas sin tocar el código base
Características 💎
Núcleo Agentico 🤖
- Bucle de Agente ReAct con ciclo Pensar → Actuar → Observar
- Integración con Ollama para inferencia LLM local (Llama 3, Mistral, etc.)
- Registro de Herramientas con definiciones JSON Schema para llamadas de función
- Gestor de Contexto con resúmenes continuos (límite de 24k caracteres para modelos de 8B)
- Almacén de Sesiones para guardar/cargar el estado de la investigación
TUI Interactiva 💻
- REPL con prompt_toolkit e historial persistente (
~/.hermes_history)
- Estilo con temática de pentesting con acentos verde/cian/naranja
- Barra de estado dinámica que muestra modelo, % de contexto y modo
- Comandos de barra:
/help, /tools, /status, /save, /load, /export, /clear, /exit
Orquestación de Herramientas 🎼
- 6 herramientas OSINT integradas listas para usar (Sherlock, TheHarvester, h8mail, Holehe, PhoneInfoga, Subfinder) 🛠️
- Arquitectura de plugins para integración fluida de herramientas de terceros 🔌
- Escáner de seguridad estática valida el código de los plugins antes de ejecutarlos: ¡sin sorpresas! 🛡️
- Ejecución multimodo: contenedores Docker, binarios nativos o autodetección híbrida 🎭
- Aplicación del modo sigiloso: bloquea herramientas de sondeo activo cuando está habilitado 🥷
Rendimiento 🚀
- La ejecución en paralelo ofrece una mejora de velocidad 2x frente a las ejecuciones secuenciales ⚡
- Escalado inteligente de recursos detecta automáticamente núcleos de CPU y memoria 💻
- Contenedores efímeros se crean, ejecutan y destruyen automáticamente 🌪️
- Workers configurables mediante la bandera
--workers para una concurrencia finamente ajustada 🎛️
Inteligencia 🧠
- Correlación entre herramientas identifica conexiones entre fuentes de datos dispares 🔍
- Deduplicación difusa elimina hallazgos redundantes de forma inteligente 🎯
- Esquema de entidades unificado normaliza la salida de todas las herramientas 📐
- Atribución de fuentes rastrea qué herramienta descubrió cada hallazgo 📝
- Puntuación de confianza cuantifica la fiabilidad de los hallazgos ⭐
Inicio Rápido 🏃♂️💨
Requisitos previos ✅
- Python 3.10 o superior 🐍
- Docker (para ejecución de herramientas en contenedores) 🐳
- Ollama con un modelo instalado (para modo TUI/agentico) 🧠
Instalación 📦
# Clone and install
git clone https://github.com/Expert21/hermes-osint.git
cd hermes-osint
pip install -r requirements.txt
pip install .
# Install Ollama and pull a model
curl -fsSL https://ollama.com/install.sh | sh
ollama pull llama3.1:8b
# Health check
hermes --doctor # 🏥 Make sure everything's ready!
Uso Básico 🎮
# 🧠 TUI Mode (default) - Conversational AI interface
hermes
# Then chat naturally: "Find social accounts for johndoe"
# 📜 Headless Mode - For scripting and automation
hermes --headless --query "Investigate the domain example.com"
# 🔧 Legacy Mode - Direct tool access (no LLM required)
hermes sherlock johndoe
hermes theharvester example.com
hermes holehe [email protected]
Comandos TUI 💬
/help # Show all commands
/tools # List available investigation tools
/status # Show current session status
/save # Save session to file
/load # Load a previous session
/sessions # List all saved sessions
/export FILE # Export report (md, pdf, html, csv, stix)
/stealth # Toggle stealth mode
/clear # Clear conversation
/exit # Exit Hermes
Uso Avanzado 🎯
# Stealth mode - passive tools only
hermes --stealth
# Blocks: sherlock, holehe, phoneinfoga
# Allows: theharvester, subfinder, h8mail
# Specific model selection
hermes --model mistral:7b
# Headless with output
hermes --headless --query "Find subdomains for target.com" --output report.md
Herramientas Disponibles 🛠️