> ## Documentation Index
> Fetch the complete documentation index at: https://vitruvio.sh/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Vitruvio is the runtime for a Boltzmann brain: portable, verifiable, model-agnostic knowledge that any model can read and none of them owns.

Vitruvio runs a **[Boltzmann brain](/docs/concepts/what-is-a-boltzmann-brain)**: a store of content-addressed, typed
blocks — the evidence you registered, what happened and when, the facts and procedures derived from it, and the
provenance tying each derivation to its source — arranged so that every version can be verified, published,
installed and reconciled with a copy somebody else advanced. The brain conserves, validates and retrieves
knowledge; an interchangeable model interprets it. **The brain returns evidence, never prose.**

```bash theme={null}
curl -fsSL https://vitruvio.sh/install.sh | sh
vitruvio --version
```

<CardGroup cols={2}>
  <Card title="Install" icon="download" href="/docs/get-started/install">
    One command, then check the version, pick extras, and keep it current.
  </Card>

  <Card title="Skills for your agent" icon="robot" href="/docs/get-started/skills">
    `npx skills add getsfumato/vitruvio` teaches an agent the contract instead of letting it guess.
  </Card>

  <Card title="Create your first brain" icon="seedling" href="/docs/onboarding">
    Standalone or inside a project, governed or ungoverned, and how to confirm it works.
  </Card>

  <Card title="What is a Boltzmann brain" icon="book-open" href="/docs/concepts/what-is-a-boltzmann-brain">
    The paper, and how the protocol works in plain words.
  </Card>
</CardGroup>

## Operating a brain

* [Working with a brain](/docs/brain/searching) — searching, browsing, ingesting, removing, publishing, migrating.
* [Sources](/docs/sources/registering-evidence) — registering evidence, declaring where material comes from, writing a source kind.
* [Projects](/docs/projects) — one project, many brains, one repository each.
* [Reconciliation](/docs/reconciliation/behind-ahead-diverged) — when the local brain and its published copy disagree.
* [Authenticity](/docs/authenticity/signing-and-trust-roots) — signing, trust roots, pins and the audit views.
* [Compound](/docs/compound/searching-several-brains) — one question across several brains of one project.
* [Catalog](/docs/catalog/classifying-evidence) — portable classifications over canonical evidence.

## For contributors

The architecture, the contributing guide and the decision records live in the repository:
[`ARCHITECTURE.md`](https://github.com/getsfumato/vitruvio/blob/main/ARCHITECTURE.md),
[`CONTRIBUTING.md`](https://github.com/getsfumato/vitruvio/blob/main/CONTRIBUTING.md) and
[`adr/`](https://github.com/getsfumato/vitruvio/tree/main/adr).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.