GUÍA OPERATIVA / INSTALACIÓN + USO

De cero a primera revisión.

Esta ruta instala el runtime, protege las credenciales, comprueba que los modelos leen documentos de verdad y deja una revisión lista para continuar después de cualquier interrupción.

Ver paquete v0.7.0 Cómo instalar

01 / VERIFICA 02 / CONFIGURA 03 / VALIDA 04 / INVESTIGA 05 / REANUDA

SETUP_HERMES.TXT / ACOMPAÑAMIENTO COMPLETO

Que Hermes te ayude a instalarlo todo.

No necesitas interpretar cada variable ni descubrir el orden correcto por tu cuenta. Dentro de la release encontrarás Setup_Hermes.txt, un contrato para que el agente explique cada decisión, mantenga los secretos fuera del chat, corrija fallos y no se detenga hasta completar la aceptación técnica.

INSTRUCCIÓN / HERMES

Lee Setup_Hermes.txt, guíame paso a paso y no declares la instalación terminada hasta que hayan pasado todas las pruebas de aceptación.

QUÉ PREPARA

Docker, identidad investigadora, endpoint, API key, tres modelos, fuentes académicas y Telegram restringido.

QUÉ DEMUESTRA

Diagnóstico, texto, JSON, visión, lectura documental y adquisición bibliográfica real.

Abre la carpeta descomprimida con Hermes y entrega esa instrucción. El agente ejecutará ./hermes-research setup; las claves se introducen en tu terminal sin eco y nunca deben pegarse en la conversación.

COMPROBACIÓN DEL HOST

Primero comprueba la máquina.

La instalación no debería empezar corrigiendo dependencias a ciegas. Estas tres órdenes confirman que el host puede ejecutar el paquete antes de descargar imágenes o entregar una credencial.

TERMINAL / HOST

docker version
docker compose version
python3 --version

CONTINÚA SI Docker responde, Compose es v2 y Python es 3.11 o superior.

DESCARGA VERIFICADA

Instala una release, no una carpeta anónima.

Cada publicación debe incluir el ZIP, su SHA-256, un manifiesto de archivos y el SBOM. La huella se comprueba antes de descomprimir: así sabes que ejecutas exactamente el artefacto publicado y no una copia incompleta.

Abrir descarga verificada v0.7.0

TERMINAL / RELEASE

shasum -a 256 -c hermes-research-pack-vX.Y.Z.zip.sha256
unzip hermes-research-pack-vX.Y.Z.zip
cd hermes-research-pack
./hermes-research setup

En Linux puedes usar sha256sum -c. El asistente crea el runtime, guarda .env con permisos 0600 y nunca imprime la API key.

UNA DECISIÓN DE INTERFAZ

Elige cómo hablar con Hermes.

CLI

Solo terminal

La opción mínima. No necesita bot ni expone una interfaz externa.

RECOMENDADO PARA PROBAR

Conversación remota

Usa un bot dedicado de BotFather y comandos públicos simplificados.

NO REUTILICES OTRO BOT ACTIVO

BOTH

Ambas entradas

La revisión conserva el mismo estado material, entre por donde entre.

ÚTIL EN OPERACIÓN CONTINUA

EL ASISTENTE PIDE

Identidad y email del investigador, endpoint, tres modelos, credencial y accesos académicos opcionales.

EL ASISTENTE NO DEBE PEDIR

Rutas del autor, nombres de proveedores privados ni secretos dentro del código.

Crossref, OpenAIRE, Europe PMC y arXiv funcionan sin credenciales. OpenAlex ofrece una cuota anónima pequeña y una clave gratuita recomendada para revisiones reales. Si tienes acceso institucional, el mismo setup activa Scopus, Web of Science, Embase o IEEE Xplore; si no, registra la omisión y continúa con las fuentes disponibles.

OBLIGATORIO

Runtime e inferencia

GitHub Releases para el paquete, un registro Docker para las imágenes y un proveedor OpenAI-compatible para la inferencia.

TARIFA PLANA · ENTORNO PROBADO

NaN.builders

Sin cobro por token y con modelos del clúster sin tope de uso. Los modelos frontera pueden tener asignación mensual. Se ha probado en ciclos de millones de tokens, pero no es un requisito del producto.

Crear cuenta en NaN.builders

ABIERTO · CUOTA DECLARADA

Descubrimiento

Crossref, OpenAIRE, Europe PMC y arXiv sin key; OpenAlex con cuota anónima o clave gratuita. Cada consulta queda registrada por fuente y fecha.

EMAIL O KEY OPCIONAL

Cobertura ampliada

Unpaywall, Semantic Scholar, Lens Scholarly y NCBI/PubMed. La ausencia reduce cobertura o cuota, pero no se oculta.

ACCESO INSTITUCIONAL

Adaptadores directos

Scopus, Web of Science, Embase e IEEE Xplore se activan únicamente con credenciales propias válidas.

EXPORTACIÓN AUTORIZADA

Fuentes especializadas

PsycINFO, CINAHL, Cochrane, ACM Digital Library, ERIC, ABI/INFORM, Business Source, EconLit y otras se registran cuando el protocolo exige una exportación disponible.

INTERFAZ OPCIONAL

BotFather crea el bot dedicado; allowlist y chat privado limitan quién puede iniciar, resolver o reanudar revisiones.

DOCUMENTO LOCAL

Docling + Poppler

Docling se ejecuta aislado dentro de Compose; Poppler mantiene el fallback. No se envía el PDF a un servicio OCR externo.

Una fuente recomendada por el contrato metodológico no equivale a una fuente consultada. Si no existe adaptador, licencia o exportación autorizada, el search-log.csv debe declararla como omitida y explicar el límite.

PRUEBA ANTES DEL CORPUS

Que el modelo exista no significa que sirva.

La aceptación separa conectividad de capacidad. Primero se levanta el runtime; después se prueba el flujo público, la lectura de una página científica y la extracción estructurada de PDF digital, tablas y OCR.

TERMINAL / ACCEPTANCE

./hermes-research up
./hermes-research smoke-test
./hermes-research multimodal-test
./hermes-research docling-test

DOCTORConfiguración y catálogo

SMOKEFlujo y artefactos reales

VISIONTítulo recuperado de un PDF real

DOCLINGTexto, tablas, figuras y OCR

No inicies una revisión costosa si falla una de las capacidades que vas a utilizar. Cambia el modelo o desactiva Docling de forma explícita; no rebajes la prueba.

PRIMER PROTOCOLO

La investigación empieza preguntando, no buscando.

El wizard pregunta tema, pregunta de investigación, ventana temporal, inclusión, exclusión y N final exacto o en rango. La frontera metodológica queda escrita antes de importar registros y se convierte en el contrato que ejecuta el resto del ciclo.

OPCIÓN A / WIZARD

./hermes-research init

OPCIÓN B / REPRODUCIBLE

./hermes-research init \
  --topic "Impacto de la IA en la carga de trabajo docente universitaria" \
  --question "¿En qué condiciones la IA reduce, desplaza o aumenta la carga de trabajo?" \
  --years 2024-2026 \
  --include "Estudios empíricos con texto completo y resultados recuperables" \
  --exclude "Opinión, marketing y estudios sin evidencia verificable" \
  --final-n 23-63

INTAKE PROTOCOLO ESTRATEGIA ESTADO

OPERACIÓN DIARIA

Cuatro acciones cubren casi todo el uso.

status

Ver

Lee fase, artefactos y bloqueos sin relanzar el proceso.

./hermes-research status

resume

Continuar

Reanuda desde el estado material y evita repetir fases completas.

./hermes-research resume

package

Empaquetar

Actualiza el paquete final cuando el gate editorial lo permite.

./hermes-research package

logs

Diagnosticar

Muestra actividad sin abrir archivos internos del runtime.

./hermes-research logs --tail 200

SI USAS TELEGRAM

Seis comandos públicos.

/start /nueva_revision /estado /reanudar /cancelar /ayuda

ANÁLISIS 0.7.0

Cuatro acciones opcionales y auditables.

intelligence memory code-audit package

intelligence reconstruye posiciones y prioridad de lectura; memory prepara contexto privado sin heredar decisiones; code-audit inspecciona repositorios declarados sin ejecutarlos. package actualiza atlas, galería, manifiesto e integridad antes del ZIP.

PERSISTENCIA

Detener Docker no borra la investigación.

01 runtime/workspace

La investigación

Protocolos, corpus, decisiones, texto, matrices, manuscritos y paquetes.

02 runtime/hermes-home

El estado operativo

Plugin, skills, logs, sesiones, watchdog y configuración mutable.

03 runtime/obsidian

La navegación opcional

Vault local para inspeccionar fichas, relaciones y trazabilidad viva.

BACKUP COHERENTE

./hermes-research down
tar -czf hermes-workspace-backup.tar.gz runtime/workspace runtime/hermes-home

Trata la copia como datos de investigación. Guarda .env por separado en un gestor de secretos y revisa licencias antes de redistribuir PDF.

DIAGNÓSTICO SIN PÁNICO

Si falla, conserva el estado y acota la causa.

01El proveedor responde, pero el modelo no aparece

Ejecuta doctor y usa exactamente el identificador devuelto por GET /models. No inventes alias locales.

02Telegram dice que existe otra sesión activa

El mismo bot está ejecutándose en otro host. Detén la instancia anterior o crea un bot dedicado; no abras dos long polling simultáneos.

03Docling consume demasiada memoria

Arranca con ./hermes-research up --without-docling. El flujo conserva Poppler, pero reduce la extracción estructurada.

04La revisión se interrumpió

No reinicies desde cero. Consulta status y usa resume; el watchdog trabaja sobre los mismos artefactos persistentes.

05El estado dice waiting_for_researcher

No es un fallo ni un rechazo. Usa disagreements, compara los juicios A/B y decide por DOI con resolve-screening. El ciclo reanuda tras el último caso sin repetir búsqueda ni descargas.

DECIDE CON EVIDENCIA

Descubre qué sabe realmente la literatura sobre tu pregunta.

Hermes Research Pack convierte literatura dispersa en una respuesta científica defendible. Hace visibles los consensos, las contradicciones, los límites de la evidencia y las preguntas que todavía merecen investigación para que puedas argumentar, decidir y publicar con una base verificable.

Descargar Research Pack Ver qué entrega