amaru encodes every AI decision through a 7-chakra serpentine scheduler, producing byte-identical, Cardano-anchored receipts that satisfy Doctrine v6 audit requirements and IETF SCITT multi-receipt transparency.
This repository's live demos, dataset mirror, and org showcase live on the SZLHOLDINGS Hugging Face org:
| Surface | Hugging Face artifact |
|---|---|
| Live demo | amaru-memory-attestation · amaru-platform |
| Deep-dive showcase | amaru-deep-dive |
| Source mirror | amaru-source |
| Org showcase | SZLHOLDINGS on Hugging Face — 22 datasets · 19+ Spaces · 2 models |
All counts are grep-verifiable from this repository.
| Metric | Count | How to verify |
|---|---|---|
| Chakra kernel modules | 7 | find src/chakras -name "kernel.py" | wc -l |
| Python modules (total) | 45 | find . -name "*.py" -not -path './.git/*' | wc -l |
| Python source lines | 2,883 | find . -name "*.py" -not -path './.git/*' -exec wc -l {} + | tail -1 |
| Test files | 5 | find . -name "test_*.py" -not -path './.git/*' | wc -l |
| Test assertions | 40 | grep -r "def test_" . --include="*.py" | wc -l |
| Total source files | 254 | find . -not -path './.git/*' -type f | wc -l |
| Zenodo DOI | 10.5281/zenodo.20434276 | resolves at https://doi.org/10.5281/zenodo.20434276 |
INPUT EVENT
│
▼
C1-KALLPA (Root · Sense capacity)
│
▼
C2-YACHAY (Sacral · Retrieve context)
│
▼
C3-RIMAY (Solar · Propose actions)
│
▼
C4-YUYAY (Heart · Score via 9 AXES)
│
▼
C5-RUWAY (Throat · Execute)
│
▼
C6-NAWI (Third-eye · Correlate tool calls)
│
▼
C7-HATUN (Crown · Mint SHA-256 receipt)
│
▼
RECEIPT → Cardano anchor (SCITT multi-receipt)
All kernels communicate via the YAWAR event bus (replay buffer · audit fiber)
# Clone and install
git clone https://github.com/szl-holdings/amaru.git
cd amaru
# Run the sidecar receipt API
cd sidecar
pip install -e .
python -m amaru.overwatch # starts receipt API on :8080
# Run the chakra pipeline
cd ..
python src/amaru_scheduler.py
# Run tests
python -m pytest tests/ sidecar/tests/ -v- Not a blockchain L1 or validator set — amaru writes receipt hashes on Cardano, does not implement consensus
- Not a token or DeFi protocol — no token is minted, no economic incentive structure
- Not production-hardened for high-volume without additional rate limiting and authn hardening
- Not a general-purpose audit log — receipts carry YUYAY 9-AXES scores and chakra provenance specific to governed AI decisions
| Repo | Role |
|---|---|
| a11oy-platform | Governed agentic execution fabric — calls amaru for receipt minting |
| sentra | Threat telemetry adapter — publishes to Yawar bus |
| rosie | Khipu receipt DAG — produces byte-strings amaru anchors |
| vsp-otel | Lambda-signed OTel spans — receipt hashes registered in amaru chain |
| agi-forecast | AI safety gauges — benchmark receipts anchored via amaru |
| szl-cookbook | Patterns and recipes — reference impl for amaru TypeScript bindings |
@software{lutar_amaru_2025,
author = {Lutar, Stephen Paul JR},
title = {amaru — Cardano-Anchored Governance Receipt Minting},
year = {2025},
doi = {10.5281/zenodo.20434276},
url = {https://doi.org/10.5281/zenodo.20434276},
license = {Apache-2.0}
}See also CITATION.cff in the repository root.
- IETF SCITT Architecture (draft-ietf-scitt-architecture-22): https://www.ietf.org/archive/id/draft-ietf-scitt-architecture-22.txt
- Urton, G. (2003). Signs of the Inka Khipu. UT Press. https://doi.org/10.7560/703442
- SZL Holdings Doctrine v6: https://doi.org/10.5281/zenodo.19944926
- Bar-Natan, D. (1995). On the Vassiliev knot invariants. Topology 34(2), 423–472. https://doi.org/10.1016/0040-9383(95)93441-4
Licensed under Apache License 2.0.
All commits require Developer Certificate of Origin sign-off (git commit -s).
SLSA provenance level 3, SBOM generation, and CodeQL static analysis are enforced on CI.
ORCID: 0009-0001-0110-4173 · Doctrine v6 compliant
Signed-off-by: Stephen Paul Lutar JR stephen@szlholdings.com