Primeros pasos

Ponga en marcha su propia instancia de Sannvit Ledger, desde una copia limpia del repositorio hasta una cadena de auditoría funcionando.

Esta sección explica cómo poner en marcha una instancia de Sannvit Ledger de principio a fin — el rastro de auditoría inmutable (append-only) y encadenado por hashes que sella cada llamada a un LLM, invocación de herramienta y recuperación que realiza un agente, en una cadena por organización, verificable de forma independiente.

Qué va a configurar

La pila tiene cinco piezas en movimiento:

Servicio	Qué hace
Postgres	La única base de datos — contiene el esquema del ledger y el propio esquema de Keycloak, sin pooler ni capa REST independiente delante
Keycloak	Autenticación para el panel y los tokens de servicio a servicio
Ledger API	Ingiere la actividad de los agentes, la sella en la cadena de hashes por organización, y ejecuta el bucle de alertas/comprobación de integridad
Dashboard	La interfaz de navegador para revisión, alertas y exportación de evidencias
Almacenamiento de blobs	Contiene el contenido de los payloads — el propio ledger solo guarda un puntero + hash — incluido mediante RustFS, o puede apuntarlo a su propio bucket compatible con S3

Por dónde empezar

Alojamiento con Docker — la vía más rápida para tener la pila en marcha, en un único host, para desarrollo o producción.
Alojamiento en Kubernetes — un chart de Helm para un clúster de cliente que necesita escalado horizontal más allá de un único host de Compose.

Más adelante se añadirán aquí otras vías (desarrollo nativo sin contenedores) a medida que esta sección crezca.

Resumen

Qué es el Registro Sannvit, cómo está construido y hacia dónde ir a continuación.

Alojamiento con Docker

Ejecute la pila completa de Sannvit Ledger — Postgres, Keycloak, la API del ledger, almacenamiento de blobs y el dashboard — con Docker Compose.