BBM-Atlas

Structural code intelligence for AI assistants. BBM-Atlas turns a repository into a knowledge graph of what calls what, what imports what and what breaks when something changes, then serves it to any AI assistant over MCP, REST, a CLI and a web console. It is local-first and LLM-agnostic: nothing has to leave your machine.

• Understand. Twelve languages parsed symbol by symbol with tree-sitter (seven more as whole files), with calls, imports and inheritance resolved across the repository and a confidence tag on every edge.
• Reason. Impact analysis, paths, cycles, god nodes and communities over the knowledge graph.
• Remember and retrieve. Repository memory, facts you tell it, lessons learned from outcomes, and four-source retrieval (structure, memory, graph, semantic) ranked into one answer.
• Serve. 32 MCP tools, 38 REST routes, 41 CLI commands and a web console, all on the same engine.
• Economise. Syntax-aware, reversible compression and a drop-in proxy that cut the tokens your assistant spends.

Install

BBM-Atlas needs Python 3.11 or newer, on Linux, macOS or Windows.

pip install bbm-atlas

# With a local embedding model and an in-process LLM:
pip install "bbm-atlas[embeddings,llm]"

Quick start

bbm-atlas serve                      # the API, and the web console at http://localhost:8000/console/

# In another shell:
bbm-atlas index ./my-repo --name my-repo
bbm-atlas search <repository_id> "how does checkout work?"
bbm-atlas impact <repository_id> shop.cart.checkout --max-depth 3

With nothing configured, BBM-Atlas keeps everything in one local database file, so indexed repositories and learned facts survive restarts. Point it at Postgres, Neo4j, Qdrant and Redis when you need to share and scale.

Connect your assistant

The running API serves its tools over MCP at http://127.0.0.1:8000/mcp:

bbm-atlas mcp install --url http://127.0.0.1:8000/mcp    # Claude Code, for this project

{ "servers": { "bbm-atlas": { "type": "http", "url": "http://127.0.0.1:8000/mcp" } } }

The second snippet is VS Code's .vscode/mcp.json.

Editions

Everything above is the Community Edition: free, with no key and no account.

The Enterprise Edition is the same package with a licence key. It adds users, service accounts and their own API keys, role-based access control, organisations on one deployment, single sign-on with OIDC or SAML 2.0, a hash-chained audit log and high availability.

export BBM_ATLAS_EE_LICENSE_KEY_FILE=./license.key
bbm-atlas enterprise license         # its state, features and seats

The key is checked offline, so nothing phones home. See pricing, or write to info@byteblendmatrix.com for a quote or an evaluation key.

Links

• Website: https://atlas.byteblendmatrix.com
• Get started: https://atlas.byteblendmatrix.com/get-started/
• Documentation: https://atlas.byteblendmatrix.com/docs/
• Enterprise: https://atlas.byteblendmatrix.com/enterprise/
• Support and sales: info@byteblendmatrix.com

Licence

BBM-Atlas is proprietary software under the BBM-Atlas License, included in the package: the Community features are free to use, and the Enterprise features need a licence key. It uses third-party components under their own licences, listed in THIRD_PARTY_NOTICES.md.