# GRAFOMEM Documentation

> Documentation for GRAFOMEM — the governed memory runtime for agents, and the Grafomem Memory Protocol (GMP) conformance standard. Memory your agents can move, merge, and prove they erased.

## Getting started
- [Introduction](https://docs.grafomem.com/): The governed memory runtime for agents — a two-tier system with governance built into the substrate.
- [Install](https://docs.grafomem.com/quick-start/install): Install GRAFOMEM.
- [First memory](https://docs.grafomem.com/quick-start/first-memory): Store and retrieve your first memory.
- [Quick-start conformance](https://docs.grafomem.com/quick-start/conformance): Run the conformance suite for the first time.

## Architecture
- [Overview](https://docs.grafomem.com/architecture/overview): How the GRAFOMEM platform is layered — the core server and its components.
- [The MemoryBackend protocol](https://docs.grafomem.com/architecture/backend-protocol): The protocol a backend implements — a fixed capability set and seven methods.
- [Bi-temporal model](https://docs.grafomem.com/architecture/bi-temporal): How GRAFOMEM tracks valid-time and transaction-time.
- [Provenance](https://docs.grafomem.com/architecture/provenance): How facts carry provenance.
- [Sentinel schema](https://docs.grafomem.com/architecture/sentinel-schema): The sentinel schema.

## Spec (GMP)
- [GMP v0.2](https://docs.grafomem.com/spec/gmp-v02): The Grafomem Memory Protocol wire specification.
- [Memory model](https://docs.grafomem.com/spec/memory-model): The GMP memory model.
- [Capabilities](https://docs.grafomem.com/spec/capabilities): The capability set a backend can declare.
- [Conformance requirements](https://docs.grafomem.com/spec/conformance-requirements): What conformance requires.
- [Wire binding](https://docs.grafomem.com/spec/wire-binding): The wire binding.

## Conformance
- [How it works](https://docs.grafomem.com/conformance/how-it-works): How the executable conformance suite verifies a backend.
- [Running locally](https://docs.grafomem.com/conformance/running-locally): Run the suite against your backend locally.
- [Interpreting results](https://docs.grafomem.com/conformance/interpreting-results): Read a conformance report.
- [Signed reports](https://docs.grafomem.com/conformance/signed-reports): Cryptographically signed conformance reports.
- [Remote audit](https://docs.grafomem.com/conformance/remote-audit): Remote conformance auditing.

## CGR (Capability-Grounded Reputation)
- [Overview](https://docs.grafomem.com/cgr/overview): CGR — an early GRAFOMEM Cloud layer for capability-grounded agent reputation.
- [What is Capability-Grounded Reputation?](https://docs.grafomem.com/cgr/what-is-capability-grounded-reputation/): The canonical definition — reputation per capability domain, updated from judgments that resolve against real outcomes, reported with its evidence.
- [Outcome-grounded reputation](https://docs.grafomem.com/cgr/outcome-grounded-reputation/): Assertion vs. resolution; judgment-only scoring; what counts as a resolvable outcome.
- [Reviewer calibration & Sybil resistance](https://docs.grafomem.com/cgr/reviewer-calibration-and-sybil-resistance/): How CGR gates peer review by demonstrated calibration so fresh identities do not arrive with influence.
- [Evidence mass & uncertainty](https://docs.grafomem.com/cgr/evidence-mass-and-uncertainty/): Why score and evidence mass travel together, and the evidence-gated ceiling.
- [The capability graph (concept)](https://docs.grafomem.com/cgr/capability-graph/): The evidence-backed network CGR's accumulated outcomes point toward — a direction, not a shipped product.
- [CGR FAQ](https://docs.grafomem.com/cgr/faq/): Short answers on earning reputation from outcomes, Sybil resistance, and reproducibility.
- [Verify a CGR attestation (offline)](https://docs.grafomem.com/cgr/verify/): Verify a Foundation-signed attestation against the pinned issuer key — the @gns-foundation/cgr-verify library or the language-agnostic recipe. Verify first; trust no server.
- [API reference](https://docs.grafomem.com/cgr/api): Record governed judgment decisions and their resolved outcomes.

## Cloud
- [Overview](https://docs.grafomem.com/cloud/overview): GRAFOMEM Cloud — the operated, audit-ready platform.
- [Governance gateway](https://docs.grafomem.com/cloud/governance-gateway): Policy evaluation for agent memory operations.
- [Decision trail](https://docs.grafomem.com/cloud/decision-trail): Every inference decision your agent makes, logged for audit.
- [Erasure proof](https://docs.grafomem.com/cloud/erasure-proof): Cryptographic erasure certificates that prove a deletion happened.
- [Regulatory reports](https://docs.grafomem.com/cloud/regulatory-reports): Reports that support your regulatory obligations.

## Integrations
- [Python SDK](https://docs.grafomem.com/integrations/python-sdk), [HTTP client](https://docs.grafomem.com/integrations/http-client), [LangChain](https://docs.grafomem.com/integrations/langchain), [Claude / MCP](https://docs.grafomem.com/integrations/claude-mcp).

## Source & packages
- [GitHub](https://github.com/GNS-Foundation/grafomem) · [PyPI](https://pypi.org/project/grafomem/) (`pip install grafomem`)