AXIOM

AXIOM is a local-first AI execution system for coordinating tools, agents, memory, and desktop automation without requiring a cloud control plane.

Core capabilities

AXIOM v1.0 executing a local tool sequence

• Event-driven execution and component registries
• Local Ollama integration
• Persistent local memory
• Sandboxed file and shell tooling
• Deterministic execution plans with dependency tracking and confirmation gates

Quick Start

Installation

Clone the repository and install the package:

git clone https://github.com/rutytoi/axiom.git
cd axiom
pip install -e .

Note: You must have Ollama installed and running locally.

Usage

Start the interactive AXIOM terminal:

axiom

You can now chat with the orchestrator, ask for system status, view registered tools, or type help for more commands.

For a full guide on using tools, agents, and Python integration, see QUICKSTART.md.

Extending AXIOM

AXIOM is designed to be easily extensible. You can build your own agents and tools to customize the orchestration layer. Check out the starter scripts in the examples/ directory:

• examples/example_custom_agent.py - How to build and register custom agents
• examples/example_custom_tool.py - How to build custom tools

Development

Run the tests with:

python -m pytest tests/

Build a distribution with:

python -m pip wheel --no-deps --no-build-isolation .