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

# Introduction

> Framework-agnostic memory control layer for AI agents

# What is Memproof?

Memproof is a native library (Python & TypeScript) that sits between your AI agent and its memory backend. Every memory operation — create, update, delete, search — passes through a control path that enforces policy, assesses risk, and produces an auditable event trail.

Memproof does **not** replace your memory store. It wraps it with governance.

## The Problem

Agent memory is now common across frameworks, but production teams face gaps:

* **Unsafe writes/deletes** are not consistently controlled
* **Memory APIs differ** by framework and provider
* **Audit evidence is fragmented** and hard to reconstruct during incidents
* **Policy enforcement** and human approval are rarely coupled to memory mutations

## How Memproof Solves This

```python theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
from memproof import Memproof

mp = Memproof(policy="./memproof.yaml", adapter="langgraph")

# Every mutation goes through the control path
result = await mp.remember(
    content="user prefers dark mode",
    scope={"tenant_id": "acme", "project_id": "chatbot", "agent_id": "agent-1"},
    context={"actor_type": "agent", "actor_id": "agent-1",
             "source": "langgraph", "timestamp": "2026-01-01T00:00:00Z"},
)

# result.status: committed | blocked | pending_approval | quarantined
# result.decision: allow | deny | require_approval | quarantine
# result.risk_assessment: score, level, factors
```

Every call produces:

1. A **risk assessment** (PII detection, secret detection, source trust, scope anomalies)
2. A **policy decision** (evaluated against your YAML rules)
3. An **immutable audit trail** (every stage of the pipeline logged via Trailproof)

## Key Properties

<CardGroup cols={2}>
  <Card title="Framework-Agnostic" icon="puzzle-piece">
    Works with LangGraph, OpenAI Sessions, MCP memory servers, or any custom backend via the adapter interface.
  </Card>

  <Card title="Embeddable" icon="code">
    Native libraries for Python and TypeScript. Import and call in-process. No HTTP server required.
  </Card>

  <Card title="Policy-Driven" icon="shield-check">
    YAML-based rules with priority ordering, 10 condition operators, and deterministic decisions.
  </Card>

  <Card title="Auditable" icon="scroll">
    Every operation emits immutable lifecycle events to a [Trailproof](https://trailproof.kyberon.dev/docs/introduction) audit trail with SHA-256 hash chains and optional HMAC signing.
  </Card>
</CardGroup>

## Architecture at a Glance

<Frame>
  <img src="https://mintcdn.com/kyberon-959a30e9/18WaBEkwKu3nQrmQ/images/memproof-flow.svg?fit=max&auto=format&n=18WaBEkwKu3nQrmQ&q=85&s=76b08ac6a6c2d9b32ec9c9ffc07b850e" alt="Memproof control path: Operation Received → Risk Assessment (5-factor scoring) → Policy Engine (YAML rules) → Decision Branching (ALLOW/DENY/QUARANTINE/APPROVAL) → Provider Attempted → Committed/Blocked → Trailproof Audit Trail" width="840" height="1180" data-path="images/memproof-flow.svg" />
</Frame>

## Next Steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Install Memproof and run your first policy-controlled memory operation in 5 minutes.
  </Card>

  <Card title="Release Info" icon="clipboard-check" href="/guides/release-info">
    See current OSS beta readiness status, quality gates, and performance baselines.
  </Card>
</CardGroup>
