Skip to content

Architecture

TaxCollector23 edited this page Oct 10, 2026 · 2 revisions

Architecture

AXIOM is deliberately small:

                 ┌──────────────────────┐
                 │  Static landing page │
                 └──────────┬───────────┘
                            │ explains
┌───────────────┐     ┌─────▼─────────────┐     ┌───────────────┐
│ Python CLI    │────▶│ Local read-only   │────▶│ JSON routes   │
│ inspect/plan  │     │ loopback daemon   │     │ /health, /api │
└──────┬────────┘     └─────────┬─────────┘     └───────────────┘
       │                         │
       ▼                         ▼
  local files              local machine facts
  and metadata             and visible tools

Repository areas

axiom/                 Python package, CLI, daemon, and MCP server
website/               Static landing page
installers/            macOS/Linux and Windows installers
scripts/               Release helpers
tests/                 Python contract and behaviour tests
e2e/                   Browser checks for the landing page
.github/workflows/     CI, Pages, and release automation

The daemon is not an inference server, hosted backend, or browser control center. The repository is authoritative when a module or route changes.

Clone this wiki locally