Docs / AI OS

Axion Dynamix AI OS In build

The AI OS is a cognitive layer that sits beside your existing agent tooling: a universal inference router any CLI or IDE can be pointed at, a long-term memory store, a limbic/affect engine, a cortex that computes confidence, and a capability engine that indexes every skill, MCP server, ACP agent and tool on the machine. It is installed as an overlay on a Hermes Agent home (~/.hermes) and runs natively on Apple silicon.

What you can run today is the Python overlay (routers, daemon, memory, cortex, plugins — 318 automated tests). The signed installer, menu-bar sidebar and search widget are In build; nothing on this page describes a feature that does not exist in the code.

Quick start (developer preview)

  1. Guided setup. python3 -m axion_core.setup_wizard — probes prerequisites, imports provider keys into the vault with your consent, checks macOS privacy permissions (it can only open the settings pane; macOS never lets software grant them), installs the LaunchAgent and the sandbox, registers the IDE MCP entry. Non-interactive: --non-interactive --choices @choices.json.
  2. Start the daemon. python3 -m axion_core.daemon --home ~/.hermes listens on 127.0.0.1:47391 (loopback only). --once runs a single tick and prints the status JSON. Endpoints: /healthz, /status, /doctor, /capabilities/counts, /capabilities/search?q=, /capabilities/route?task=.
  3. Start the router. python3 -m axion_core.router --home ~/.hermes [--port N] [--cortex] [--no-memory]; configuration lives in ~/.hermes/axion/router.json. Point any OpenAI- or Anthropic-compatible client at the router's base URL; upstream API keys are referenced by environment-variable name in the config and are never written to disk by the router.
  4. Sign in and add providers. axion account login signs the AI OS into your Axion Dynamix account and caches the entitlement for seven days (axion account status | refresh | logout). axion providers add nim --kind openai --base-url https://integrate.api.nvidia.com/v1 --model <id> --key-stdin reads the key once from stdin and stores it in the macOS Keychain under com.axiondynamix.providers; router.json records only the Keychain account name. axion providers list | test | set-default | remove. The daemon exposes the same at GET /account, POST /account/login | refresh | logout for the widget and the IDE.
  5. Inside Hermes. The plugins register tools under the axion_ prefix — memory (axion_memory_store / retrieve / reflect / provenance / feedback), limbic (axion_limbic_state / signal / predict / prior / contingency), cortex (axion_self_model, axion_calibration, axion_goal_contract, axion_indicators, axion_situation, axion_authority), capability engine (axion_capability_search / route / refresh), vault (axion_vault_request / list / leases / revoke), and axion_skill_forge, axion_improvement, axion_knowledge.

Architecture

A task is perceived once and processed concurrently by seven regions — perception (task class, risk terms, vagueness), hippocampus (hybrid memory recall scored by cosine relevance, with provenance), amygdala (salience and risk posture from the limbic state plus explicit destructive/credential terms), prefrontal (decomposition into checkable steps, verified against active goal contracts), cerebellum (procedural recall), basal ganglia (action selection among answer · plan-and-execute · delegate · ask · refuse) and anterior cingulate (conflict among decision-bearing regions). Signals compete for a global workspace; the cortex integrates the winning coalition into a Decision.

Confidence = salience-weighted region confidence × agreement × a calibration shrink learned per task class. A critic then reviews the draft and may only lower confidence or demand clarification — an invariant covered by tests over the full product space of inputs. Every decision carries temporal context (wall time, uptime, tempo, time since last feedback) and objective context (which approved goal it serves and how closely it approaches a forbidden clause).

Feedback closes the loop: the prospective prediction is resolved, memories used are credited or discounted, affect updates, an uncertainty gate and a Bayesian change-point detector adapt, and two calibration tracks (per task class, and for the critic itself) are appended. Grounding: global workspace theory, appraisal theory, metacognitive monitoring; the self-model follows the component list of arXiv:2607.12254, which defines self-awareness functionally and disclaims subjective experience — so do we.

Universal router

A loopback gateway (127.0.0.1:47392) accepting POST /v1/chat/completions (OpenAI) and POST /v1/messages (Anthropic), forwarding to any configured OpenAI-compatible, Anthropic or Ollama upstream. Point a tool at it by setting its base URL; keys are referenced by environment-variable name in router.json and never serialised.

Capability detection: declared in config → conservative model-family matrix → a one-time live probe whose result is cached. Supplementation: models without tool calling receive the axion-json-v1 fenced protocol and their output is parsed back into standard tool_calls (malformed blocks are returned as tool errors, never guessed); image parts are described by a configured vision provider for text-only models, and if none is configured the request is refused with HTTP 422 rather than silently stripped; relevant memories are injected only above a cosine-relevance floor; an optional cortex pre-pass adds plan, risk and confidence for multi-step directives; limbic modulation sets temperature/top-k only when the client left them unset.

Streaming: native SSE pass-through whenever possible; when tool supplementation forces buffering the response is still delivered as SSE and the x-axion-stream: buffered header says so. Every response carries x-axion-caps and x-axion-notes so you can see exactly what was supplemented.

Memory & privacy

Three tiers — episodic, semantic, procedural — in a SQLite store under your home directory, with embeddings, FTS5 keyword index and a provenance graph. Retrieval orders candidates by reciprocal-rank fusion of semantic and keyword ranks plus one-hop provenance expansion, then gates each on cosine relevance, so a lone unrelated record is never injected merely because it ranked first. Writes pass an affect-derived salience gate; consolidation and insight passes run on schedule. Export and purge are single commands; nothing is transmitted to Axion Dynamix.

Licensing & tiers

An entitlement is the store's signed answer to "is this account's subscription active for this product, and at which tier" — fetched with your account session, cached on-device for seven days, and re-checked at most daily. There are no licence files, issuer keys or device bindings to manage; revoking a session in the dashboard locks that device at its next check. Subscriptions are confirmed server-side against PayPal before any licence is minted; the licence lease never outlives the paid period plus a seven-day grace window. Access states: active → renewing (24 h before expiry) → grace (7 days, banner) → locked (paywall, subscription management, data export and diagnostics remain available; model calls, tools and automation pause). Changing tier creates a new subscription; nothing unlocks until the new tier's licence is installed. Device binding is optional. 36 automated tests cover forgery, expiry, downgrade attempts and tier gates.

Security model

All local services bind to loopback and reject non-loopback Host headers. Credentials live in a vault with explicit grant/deny/revoke and an audit log; the router reads provider keys by variable name only. Signed entitlements, signed skill packages (planned), and a post-quantum vault using ML-KEM-1024 and ML-DSA-87 (NIST FIPS 203/204) releasing secrets only to the verified active session, approved automations and scheduled tasks (planned). What we deliberately do not do: TLS interception, process injection, or capturing traffic from applications you have not pointed at the router.

Evidence & claims

Shipped core: cortex (31 tests), router (20), entitlements (24), paywall (12), account (6), CLI (3), plus the pre-existing substrate suites — 183 passing on the live tree. The consciousness-indicator evaluation follows arXiv:2308.08708 and reports each indicator as present, partial or absent. Benchmarks of a bare model versus the same model behind Axion (recall, coherence, calibration, latency overhead) are published with confidence intervals when measured — never before. Our citation audit corrected five mis-titled references in earlier material and is public on request.

Status, honestly

ComponentStatusEvidence
Universal router (OpenAI + Anthropic dialects, tool/vision supplementation, memory injection)Shipped19 tests + socket test
Long-term memory (three tiers, hybrid retrieval, consolidation)Shippedmemstore test suites
Cortex: global workspace, critic region, calibration, goal contractsShipped31 tests
Limbic engine: appraisal, neuromodulation, change-point detectionShippedlimbic + neuromod tests
Capability engine + daemon bridgeShippeddaemon bridge tests
Account entitlement (no licence files), paywall state machine, Keychain provider keys, axion CLI, Master editionShippedaccount 6 · paywall 12 · entitlements 24 · CLI 3 · daemon account routes 1 — all passing
Consciousness-indicator battery (functional indicators, scored — not a sentience claim)In buildindicator assessor exists; executable battery pending
Liquid Glass sidebar and search widget, signed installer, embedded orchestrator modelIn build—
Windows and Linux buildsPlannedafter the macOS release