Atlas Mind is a knowledge-base engine where your notes stay plain files in your own private git repository, served by an engine you can read line by line — and an external brain you share with your AI over an open protocol. Own the data. Own the engine. Own the mind.
No account. No upload. The demo is the real viewer, running entirely in your browser.
Notion, and every hosted notes app, ask you to pour your thinking into their structure, on their servers, in their format. Leave, and you fight an exporter to get a tangle of files back. Your AI assistant reads your brain only by pulling it into their cloud.
Atlas Mind inverts that. Your knowledge never leaves your disk, and nothing you write trains anyone's model.
Everything ships in the box — a single Python server on the standard library, no database, no third-party network calls.
Markdown is first-class — rendered, linked, searched. But Atlas also previews standalone HTML decks, PDFs and Word .docx inline, converted in your browser. Nothing uploaded anywhere.
Atlas is the memory your assistant reads and enriches. It exposes an MCP endpoint with seven tools, and atlas init scaffolds the conventions so an AI knows how to use your mind.
One Python HTTP server plus a build step, entirely on the standard library. No database — accounts and share links are plain JSON on disk. Fonts and libraries are vendored, so it makes no outside calls.
If Atlas Mind disappeared tomorrow, your mind would still open in any text editor.
It's just a folder of files in your own private git repository. You are never holding someone else's format hostage.
Point the engine at a mind and it serves a fast single-page app. Upgrading the engine never touches your content; syncing content never touches the engine.
This repository: the Python server, the build step, and the single-page viewer. Read it line by line. Replace it. Your notes don't care.
Your notes, in their own private git repository: a content/ folder plus a small atlas.toml. State lives in a local .atlas/ — plain JSON, no database.
A wikilink [[graph]], full-text search, backlinks, tags, and a force-directed mind palace — built on top, from your files.
Two Atlas instances can share a slice of their content and form a Hive Mind — a personal memory with sharing, not a real-time collaborative editor. It's pull-asymmetric: only the publisher needs to be reachable, the subscriber just pulls.
Pick a folder or a single document and publish it. You get a one-time atlas-node:… link carrying the origin URL and a read-only token (stored hashed, re-issue to rotate).
Paste the link on another instance. Atlas downloads the documents and keeps a read-only mirror under remotes/, re-syncing by SHA-256 diff on every pull.
Mirrored docs appear in the tree and as their own teal regions in The Mind. “Appropriate” forks an editable copy — and your AI reads them like any other note.
Tokens are scoped to the published path and revocable at any time. Nothing on your side is ever overwritten without a sync you control.
Installs a self-contained atlas command — the viewer ships inside the package, no separate download.
# install (uv fetches Python for you) — or: pipx install atlas-mind uv tool install atlas-mind # scaffold a new mind and serve it locally atlas init ~/my-mind atlas serve ~/my-mind # keep it current — upgrade the CLI, or update a deployment uv tool upgrade atlas-mind atlas update --target <fly|compose|systemd> # …or try it once, no install uvx atlas-mind serve ~/my-mind