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.

Descargar paquete v0.3.0 Cómo instalar

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

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.3.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

Endpoint, modelo principal, modelo visual, modelo revisor y credencial.

EL ASISTENTE NO DEBE PEDIR

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

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

VISIONLectura efectiva de página

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

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.

DE PREGUNTA A RESULTADO

Convierte una pregunta compleja en una revisión completa, trazable y editable.

Hermes Research Pack entrega un corpus depurado, una matriz de evidencia, fichas por estudio, figuras útiles y un manuscrito en Markdown, LaTeX y PDF sometido a revisión independiente. Recibes una investigación que puedes auditar, continuar y preparar para publicación; no una conversación, un resumen ni una carpeta de borradores.

Descargar Research Pack Ver qué entrega