aaax 0.1.0

Agentic exokernel for governed multi-system AI runtimes

AAAX

Agentic exokernel for governed multi-system AI runtimes.

AAAX sits above sssn and lllm and gives that stack an operating-system-style control plane:

• dock and wire modules into a governed constellation
• issue and revoke capabilities for mediated resources
• authorize side effects through an action gate
• manage lifecycle events like revoke, pause, resume, and drain
• bridge the default LibOS to lllm
• provide the first-class kernel contract for higher applications such as the Productive Suite

The current codebase is the first kernel slice: bootstrap, governance channels, policy engine, module loading, lifecycle control, and a minimal LLLM bridge are implemented and tested.

Install

pip install aaax

AAAX targets Python 3.10+ and installs its framework dependencies through PyPI:

• sssn for the network substrate
• lllm-core for the default LibOS bridge

Quick Start

Create a minimal kernel config:

[aaax]
id = "aaax-main"
name = "AAAX Kernel"
policy = "default"

[aaax.libos]
name = "lllm"
strict_boot = true
discover_shared_packages = false

[aaax.network]
publish = false
host = "0.0.0.0"
port = 8100

[[aaax.modules]]
id = "example-agent"
framework = "custom"
channels = []
executors = []
remote_channels = []

Launch the kernel:

aaax launch aaax.toml

Or from Python:

import asyncio

from aaax import AAAXConfig, bootstrap_kernel


async def main() -> None:
    config = AAAXConfig.from_file("aaax.toml")
    kernel = await bootstrap_kernel(config, start_channels=True)
    await kernel.step()


asyncio.run(main())

Architecture Stack

Productive Suite and other AAAX applications
                  |
                AAAX
                  |
      LLLM (default LibOS) + other LibOS adapters
                  |
                SSSN

• SSSN remains the transport and topology substrate.
• LLLM remains the first LibOS and package/runtime layer.
• AAAX owns governance, module trust, capability issuance, action authorization, and lifecycle.
• Productive Suite is the first citizen of AAAX, not a kernel dependency.

Project Layout

aaax/                  Python package
docs/                  MkDocs site for aaax.one
notes/                 design and implementation notes
sssn/                  vendored local framework source for development
lllm/                  vendored local framework source for development

Documentation

Full documentation is published at aaax.one.

• Getting started: installation, config, and first launch
• Architecture: kernel functions, framework boundaries, Productive Suite positioning
• Core reference: config, governance, module loading, and LibOS bridge
• API reference: public AAAX Python entry points

Development

For monorepo development against the local framework copies:

pip install -e ./sssn
pip install -e ./lllm
pip install --no-deps -e .
pip install -r requirements-monorepo.txt
pytest aaax/tests -q
python -m mkdocs build --strict
python -m build

The published package still works outside this repo through normal PyPI dependencies. Inside the monorepo, _vendor.py prefers the checked-out sssn/ and lllm/ trees when they exist.