Metadata-Version: 2.4
Name: aaax
Version: 0.1.0
Summary: Agentic exokernel for governed multi-system AI runtimes
Author: Junyan Cheng
License-Expression: Apache-2.0
Project-URL: Homepage, https://aaax.one
Project-URL: Documentation, https://aaax.one
Project-URL: Repository, https://github.com/Productive-Superintelligence/aaax
Project-URL: Issues, https://github.com/Productive-Superintelligence/aaax/issues
Keywords: agents,agentic systems,multi-agent,governance,kernel,sssn,lllm
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0
Requires-Dist: lllm-core>=0.1.1
Requires-Dist: pydantic>=2.0
Requires-Dist: sssn>=0.0.1
Requires-Dist: tomli>=2.0.1; python_version < "3.11"
Provides-Extra: dev
Requires-Dist: build>=1.2.2; extra == "dev"
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
Requires-Dist: twine>=5.1.1; extra == "dev"
Provides-Extra: docs
Requires-Dist: mkdocs-autorefs>=1.0; extra == "docs"
Requires-Dist: mkdocs-material>=9.5; extra == "docs"
Requires-Dist: mkdocstrings[python]>=0.26; extra == "docs"
Requires-Dist: pymdown-extensions>=10.0; extra == "docs"
Dynamic: license-file

<div align="center">
  <h1>AAAX</h1>
  <h4>Agentic exokernel for governed multi-system AI runtimes.</h4>
</div>

<p align="center">
  <a href="https://aaax.one">
    <img alt="Docs" src="https://img.shields.io/badge/docs-aaax.one-black">
  </a>
  <a href="https://pypi.org/project/aaax/">
    <img alt="PyPI" src="https://img.shields.io/pypi/v/aaax.svg">
  </a>
  <a href="https://github.com/Productive-Superintelligence/aaax/blob/main/LICENSE">
    <img alt="License" src="https://img.shields.io/github/license/Productive-Superintelligence/aaax">
  </a>
</p>

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

```bash
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:

```toml
[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:

```bash
aaax launch aaax.toml
```

Or from Python:

```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

```text
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

```text
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](https://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:

```bash
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.
