---
title: "NovaFabric Tutorials"
description: "Concepts — capsule structure, capture hook mechanism, replay modes, lineage edge types - CLI reference — every nova command with flags and examples…"
canonical: https://novafabric.ai/docs/tutorials/
last_updated: 2026-08-05
source: https://github.com/MSKazemi/novafabric/blob/main/docs/tutorials/README.md
---

# NovaFabric Tutorials

Plain-English guides for engineers at every level. Read in any order.

---

## Start here

| Tutorial | What you learn |
|---|---|
| [Why NovaFabric?](https://novafabric.ai/docs/tutorials/why-novafabric/) | The problem it solves, with five concrete scenarios using real testbench workloads |
| [Prove a run to an auditor](https://novafabric.ai/docs/tutorials/prove-a-run-to-an-auditor/) | The scenario the project exists for: capture and seal a run, archive it, then six months later verify it is unmodified, replay it offline, and hand over an Evidence Bundle — with an explicit section on what it does *not* prove |
| [Getting Started](https://novafabric.ai/docs/getting-started/) | The 15-minute first run: install, capture, validate, replay, diff, lineage, seal |
| [Feature tour](https://novafabric.ai/docs/tutorials/feature-tour/) | Hands-on tour of every capability — proxies, all providers, LangChain, evidence bundles, knowledge graph, capture-level policy, GDPR erasure, dashboard reports, topology, compliance exports, the zero-token eval loop, intervention replay, the Accountability Spine (energy / ledger / safety case), incident tracking, plus the Langfuse-parity cohort: prompt lifecycle and labels, offline analytics (query / views / trends / pricing), sessions and the execution graph, and the team evaluation workflow |
| [5-minute black-box recorder demo](https://github.com/MSKazemi/novafabric/blob/main/examples/blackbox_demo/README.md) | End-to-end demo: capture → validate → scan-secrets → replay → diff → lineage → verify; no live API key required |

---

## Go deeper

| Tutorial | What you learn |
|---|---|
| [How capture works](https://novafabric.ai/docs/tutorials/how-capture-works/) | What HTTP is, what `requests` and `aiohttp` are, how monkey-patching intercepts LLM calls without code changes, the URL registry, all four capture modes |
| [Multi-agent capture](https://novafabric.ai/docs/tutorials/multi-agent-capture/) | Same-process vs separate-process topologies, how to capture each, MCP sub-agents, the parent/child linking design (ADR-0032) |
| [Cluster scale — 1,000,000 agents](https://novafabric.ai/docs/tutorials/cluster-scale/) | Where capsules live (always filesystem), why the current single-cluster design doesn't reach 1M agents, the self-contained rule, the four-layer architecture, the three hard problems (storage, lineage, identity), and the phased build plan |

---

## Compare and evaluate

| Tutorial | What you learn |
|---|---|
| [NovaFabric vs Langfuse](https://novafabric.ai/docs/tutorials/novafabric-vs-langfuse/) | Where they overlap, where they differ, honest assessment of what each does better |

---

## Related docs

- [Concepts](https://novafabric.ai/docs/concepts/) — capsule structure, capture hook mechanism, replay modes, lineage edge types
- [CLI reference](https://novafabric.ai/docs/cli-reference/) — every `nova` command with flags and examples
- [User guide](https://novafabric.ai/docs/user-guide/) — every shipped command, organized by workflow
- [Developer guide](https://novafabric.ai/docs/developer-guide/) — local dev setup, extension points, contributing
- [ROADMAP.md](https://github.com/MSKazemi/novafabric/blob/main/ROADMAP.md) — release sequencing v0.1 → v1.0