# atlaso SDK — Documentation

<!-- Canonical: https://www.atlaso.ai/docs -->

> A memory store that flags its own conflicts before your agent does.

The full rendered docs site lives at **<https://www.atlaso.ai/docs>**. The files in this folder are the same content as plain Markdown so you can read it without leaving GitHub.

The website is the source of truth — when the two diverge, the website wins. Open an issue if you find drift.

---

## Read in this order

| Page | What it covers |
|---|---|
| [Getting Started](./getting-started.md) | Install, quickstart, your first deposit and recall. |
| [Concepts](./concepts.md) | Field 3.0 mental model — deposits, polarity, evidence, scope, confidence, conflict, idempotency. |
| [API Reference](./api-reference.md) | `Memory`, `AsyncMemory`, `UserHandle` — every method, signature, kwarg. |
| [Data Types](./data-types.md) | `Deposit`, `SearchResult`, `Diagnostics`, `AddResult`, `RetractResult`, `PeekView` … |
| [Errors](./errors.md) | The full exception hierarchy + which transport errors are retried. |
| [Architecture](./architecture.md) | The gate, retrieval pipeline, storage layer — with diagrams. |
| [CLI](./cli.md) | Every `atlaso` subcommand. |
| [MCP & Hooks](./mcp-and-hooks.md) | `atlaso mcp` for Claude Code / Cursor / Codex / Windsurf / Cline + auto-memory hooks. |
| [Configuration](./configuration.md) | Env vars, storage-path resolution, transport injection. |
| [Admin](./admin.md) | Cross-tenant operations behind a literal-confirm wall. |
| [Recipes](./recipes/) | Framework integrations — LangChain · LlamaIndex · DSPy · OpenAI Agents · CrewAI. |

## Quick links

- Website docs: <https://www.atlaso.ai/docs>
- Source: <https://github.com/imashishkh21/atlaso>
- Issues: <https://github.com/imashishkh21/atlaso/issues>
- PyPI: <https://pypi.org/project/atlaso/>

## Sixty-second pitch

```python
from atlaso import Memory

m = Memory()
user = m.for_user("alice")

user.add("Alice prefers oat milk in lattes")

results = user.recall("milk")
print(results.explain())            # bag-level verdict
for r in results:
    if r.has_disagreement:
        print("WARN", r.content, "conflicts with", r.conflict_peers)
    elif r.is_confident:
        print("OK  ", r.content)
    else:
        print("?   ", r.content)
```

Most memory stores return hits. Atlaso returns hits **plus a verdict on whether the hits are settled**. The defining mechanic is at [Concepts → Confidence & conflict](./concepts.md#confidence--conflict).

## Status

`atlaso==0.1.0a4` — research preview. Apache-2.0. Python 3.10+. Zero telemetry. Only runtime dependency is `httpx`.

---

<!-- atlaso:doc-trailer -->
**Source:** <https://www.atlaso.ai/docs>  
**Edit on GitHub:** <https://github.com/imashishkh21/atlaso/tree/main/docs/README.md>  
**Updated:** 2026-05-12