Volver a actualizaciones
Nuevo releaseJul 14, 2026

halo-record v0.2.7

Registros de tiempo de ejecución a prueba de manipulaciones para agentes de IA. Encadenados con hash, sin dependencias, verificables por cualquiera.

Compartir

halo-record

Rastros de auditoría a prueba de manipulación para agentes de IA — Runtime Records encadenados por hash, renderizados como un Runtime Report que tus clientes pueden verificar por sí mismos.

Cada acción que captura tu instrumentación (llamadas a herramientas, llamadas a modelos, acceso a datos, aprobaciones) se convierte en un Runtime Record en un registro de solo adición encadenado por hash; el Runtime Report es esa cadena renderizada como una página HTML que recalcula la cadena de hash en el navegador del lector y renderiza lo que muestra a partir de los registros que verificó (para una comprobación que no dependa del propio código de la página, ejecuta halo verify sobre el JSONL). Cualquier parte que posea un checkpoint de la cadena puede verificar que los registros hasta ese checkpoint no han sido alterados desde que se tomó, sin confiar en quien los produjo — ese checkpoint es la pieza fundamental: la cadena por sí sola es a prueba de manipulación frente a todos excepto la parte que opera el registrador (LIMITS.md §1). Cuando el equipo de seguridad de un cliente pregunta "¿qué hizo tu agente con nuestros datos?", les entregas un enlace en lugar de un párrafo. Las revisiones de seguridad ya plantean preguntas sobre IA junto a la lista de verificación SOC 2 — y cada vez más esas preguntas provienen de ISO 42001, de los artículos sobre mantenimiento de registros del Reglamento de IA de la UE y de los propios cuestionarios de los clientes. Hoy en día una garantía por escrito todavía basta. La apuesta detrás de este proyecto es que no lo hará por mucho tiempo.

"Veinte años en informática forense te enseñan que una evidencia solo es evidencia si la otra parte puede comprobarla... en un campo lleno de productos de IA que piden confianza, [Halo] es el raro diseñado para hacer innecesaria la confianza."

Johannes Stillig, Fundador y CEO de Tidebreak AI y Group CISO en una oficina de inversión privada

Destacado en Help Net Security · Top 4% de los lanzamientos de Show HN esa semana · Listado en Agentic Trust Controls frente a cinco controles

El formato del registro es abierto y libre de implementar. Este paquete es la implementación de referencia: registrador, verificador, cliente testigo y servidor de informes.

¿Usas halo-record o estás pensando en ello? Cuéntame quién eres y para qué → ¿Quién usa halo-record?

Compruébalo tú mismo

Te están pidiendo que pongas un registrador dentro de tu agente. No deberías aceptarlo por fe:

  • Cero dependencias en tiempo de ejecución. Solo la biblioteca estándar. pip install halo-record instala exactamente un paquete.
  • Sin llamadas de red, excepto cuatro opcionales — el anclaje a un testigo (envía el id del sujeto, un recuento de registros y dos huellas de la cadena — la cabeza y la raíz de la cadena), la lectura de los checkpoints de un testigo (envía el id del sujeto), la marca de tiempo RFC 3161 (envía solo el hash de estado de un checkpoint a una Autoridad de Sellado de Tiempo) y halo serve --verify-email (envía un código de un solo uso y el nombre del sujeto del informe, por SMTP a través del servidor que configures en $HALO_SMTP_HOST, a la dirección que introduce un visor del informe). Todas están desactivadas a menos que las invoques; ningún otro contenido de los registros sale de tu infraestructura.
  • Los argumentos sin procesar de las herramientas se someten a hash, con un resumen redactado junto a ellos. Los argumentos se almacenan como un hash canónico más un resumen: el texto del argumento con los patrones conocidos de secretos y PII enmascarados, limitado a 200 caracteres. Una entrada corta que no coincide con ningún patrón aparece completa en el resumen; el modo solo-hash (summaries=False) no conserva ningún resumen. La redacción es de mejor esfuerzo (regex sobre formatos comunes de secretos y PII más un comodín de entropía): trátala como defensa en profundidad, no como una garantía. Los campos de resultado que proporciones más allá de summary se escanean y enmascaran con los mismos patrones, pero no se recortan a 200 caracteres (LIMITS §13).
  • Lo suficientemente pequeño para auditarlo. ~8.700 líneas de Python, incluidos el JavaScript y el CSS incrustados en la página del informe (líneas de código, sin contar líneas en blanco, comentarios y docstrings). Léelo entero en un día.
  • Apache-2.0.
  • La documentación es de primera clase. LIMITS.md (lo que la cadena no puede demostrar), PRIVACY.md (qué contienen los registros y qué sale de tu máquina), RETENTION.md (operar bajo una política de retención) y REVIEWERS.md — la comprobación independiente de cuatro comandos más un formato de cita para los hallazgos de la revisión.

Qué demuestra cada capa — la distinción fundamental en este proyecto (LIMITS.md §1): una cadena que tú mismo posees demuestra que los registros no fueron editados, en relación con una cabeza que alguien ya posee; solo los checkpoints mantenidos fuera del operador demuestran que ninguno fue eliminado; y ningún hash demuestra que cada acción fue capturada.

AfirmaciónCadena propia+ Checkpoints externos+ Captura confiable
Detectar ediciones en un artefacto establecido✔✔✔
Detectar la reescritura del historial confirmado—✔✔
Detectar checkpoints faltantes/tardíos—✔ (cadencia acordada)✔
Demostrar que cada acción fue registrada——depende del límite de captura

Ve uno antes de instalar: un informe de ejecución de ejemplo — datos ficticios, cadena real, y su script recalcula en tu navegador la cadena de hashes de los registros incrustados cuando lo abres.

Demostración de 60 segundos

No se requiere ningún agente. Con uv, no hay nada que instalar:

uvx --from halo-record halo demo --serve

o la forma clásica:

pip install halo-record
halo demo --serve

Cualquiera de las dos opciones crea un proveedor ficticio de agentes de soporte con dos clientes, es testigo de las cadenas (con un archivo testigo local que representa a alguien fuera del operador — véase LIMITS.md §1), sirve sus Runtime Reports restringidos y abre la consola del operador en tu navegador. Luego prueba la prueba de manipulación: elimina una línea de uno de los archivos .jsonl y recarga. El informe lo detecta.

Registra tu propio agente

Una línea en el límite:

from halo_record import trace

agent = trace(run_my_agent, profile="my-agent", log="audit.jsonl")   # wraps your entrypoint; records the run boundary to ./audit.jsonl — add record_call() or a framework adapter at each tool boundary to capture individual calls

También se incluye un shim de conveniencia from halo import ..., pero el nombre halo en PyPI pertenece a un paquete de spinner de terminal no relacionado, y si ese paquete está instalado, gana la importación. halo_record no es ambiguo, por lo que los ejemplos lo usan.

Sin log=, los registros van a ~/.halo/my-agent.jsonl (una cadena por agente). El wrapper sella el límite de la ejecución; la evidencia vive en los registros por llamada. Captúralos con un adaptador de framework (matriz a continuación) — o explícitamente, lo que también muestra cómo se enlaza la delegación:

Categorías