Documentación
Lo suficiente para dejar un nodo corriendo y una skill hablándole. La referencia completa —cada comando, los cinco contratos, la API HTTP y WebSocket y el modelo de seguridad— vive en el repositorio, y dentro del propio nodo: el plano de control trae toda la referencia sin conexión.
Requisitos
Ninguno para correr el binario del release. Go 1.25+ solo para compilar desde el código; Python 3.11+ para correr las skills en Python; Node 22+ solo para recompilar la UI del plano de control, que viene precompilada y embebida. Sin CGO, sin Docker, sin base de datos, sin cuenta.
Instalar
- 1 Descarga un binario firmado del release:
aura-linux-amd64,aura-darwin-arm64,aura-windows-amd64.exey los otros tres targets, másSHA256SUMS, su firma cosign y el SBOM. - 2 Verifica:
sha256sum -c SHA256SUMS --ignore-missing, y luegocosign verify-blobcontra la identidad del workflow de release — ver SECURITY.md. Comprueba la firma antes de confiar en las sumas, no después. - 3 O compila:
git clone https://github.com/DeepAxiom/deepaxiom_aura && cd deepaxiom_aura/kernel && go build -o aura ./cmd/aura - 4 O como servicio:
docker compose up— kernel, volumen persistente y la política estricta dedeploy/aura.policy.yaml.
Arranque rápido
- 1 Arráncalo:
aura up— imprime un banner con la URL del plano de control y un token - 2 Conecta una skill:
cd skills/echo && PYTHONPATH=../../sdk/python/src python main.py - 3 Háblale:
aura chat --graph echo "hola aura"— no necesita ningún modelo - 4 Protege un agente que ya corres:
aura guard --config claude_desktop_config.json
⚠︎ Las banderas van antes del mensaje: aura chat --graph echo "hola" funciona, aura chat "hola" --graph echo ignora la bandera en silencio. Y aura chat sin --graph usa el grafo chat, que necesita un LLM — echo es el que funciona en frío.
$ aura chat --graph echo "hello aura"
hello aura
# that round trip went client → kernel → executor → skill → back,
# over a WebSocket, every envelope logged before it was acknowledgedEl registro público y Studio
registry.deepaxiom.com sirve la API r1. aura add verifica e instala; AURA_REGISTRY fija el valor por defecto. Publicar necesita una credencial de publicador en la URL — AURA_REGISTRY=https://publisher:PASS@registry.deepaxiom.com aura publish mi-skill/ — que se entrega a petición. Studio — studio.deepaxiom.com — es el frente web: explorar y descargar hoy, publicar desde el navegador después, leyendo el registro solo por esta API.
Referencia de CLI (selección)
Ejecutar
| aura up | Arranca un nodo: kernel, UI, almacén de estado, bitácora y cliente de testigo |
| aura chat | REPL o conversación de un tiro con un grafo, con respuestas en streaming |
| aura do | Meta en lenguaje natural → plan → ejecución con compuertas |
| aura connect | Proyecta una especificación OpenAPI existente como skills |
Demostrar
| aura guard | Pon servidores MCP existentes tras un punto de control con política |
| aura verify | Recomputa la cadena, el árbol y las firmas de la bitácora sin ningún nodo corriendo |
| aura audit | Un reporte por periodo de qué actuó, quién lo autorizó y bajo qué política |
| aura why | Narra la causa raíz de una sesión desde su log causal |
| aura replay | Reproduce de forma determinista una sesión grabada |
| aura regress | Reproduce sesiones contra un modelo nuevo y compara los efectos |
| aura undo | Revierte un efecto por su puerto de compensación declarado |
| aura backup | Archiva el directorio de datos — identidad, bitácora, secretos — y verifica una restauración |
Distribuir
| aura publish | Firma y sube una skill a un registro |
| aura add | Descarga, verifica hash y firma, revisa permisos, instala |
| aura registry serve | Aloja tu propio registro, en su propio puerto |
| aura federate | Resuelve capacidades que físicamente viven en otro nodo |
Los cinco contratos congelados
C1 manifiesto, C2 IR de grafo, C3 protocolo de canal, C4 bitácora de efectos y política, C5 atestación. Versionados, solo aditivos, y acompañados de una suite de conformidad de caja negra que habla el protocolo crudo — cualquier implementación que la pase es conforme.
La referencia completa
La guía cubre cada comando, los cinco contratos, la API HTTP y WebSocket, el despliegue y el modelo de seguridad completo.