Installation

Install

pip install atlaso

Tested on CPython 3.10, 3.11, 3.12, and 3.13. The only runtime dependency is httpx>=0.27,<0.29 — atlaso never imports an LLM client.

Optional extras

The MCP server is gated behind one extra. The framework names below are reserved — they pin the namespace so future adapters can ship under those import paths, but the v0.1 wheels contain no adapter code.

# MCP server (fastmcp) — real
pip install "atlaso[mcp]"

# Reserved namespaces — no code, just the name
pip install "atlaso[langchain]"
pip install "atlaso[llamaindex]"
pip install "atlaso[dspy]"
pip install "atlaso[openai-agents]"
pip install "atlaso[crewai]"

Verify the install

The doctor runs an end-to-end sanity check: import path, vendored engine, storage resolution, and an add → recall → retract round-trip in a tempdir.

atlaso doctor

A healthy install returns exit code 0 and prints the resolved storage path with its source (constructor / ATLASO_PATH / ancestor walk).

Requirements summary

• Python ≥ 3.10
• SQLite 3.35+ with FTS5 (included in standard CPython builds)
• httpx (auto-installed)
• ~3 MB disk for the package, plus your field DB

Upgrading

pip install --upgrade atlaso

Atlaso is currently 0.1.0a4 — a research preview. We aim for backward-compatible additions inside the alpha track, but read the release notes before each upgrade.