Quickstart

Get Started with OAR

OAR (Omnipotent Agentic Runtime) is a local-first orchestration platform with 12 specialized agent roles, persistent memory, and self-correcting protocols. Follow these steps to have it running on your hardware in under five minutes.

Prerequisites

✓Docker — Desktop (macOS/Windows) or Engine (Linux)
✓Git — to clone the repository
✓8 GB RAM minimum (16 GB recommended)

01Clone & Initialize

Clone the Omnipotent repository and run the initializer to scaffold your local configuration.

git clone https://github.com/RJS-SOFTWARE-LABS/omnipotent.git
cd omnipotent
./bin/omnipotent init

This creates federation.json, .env, and the kernel/ directory structure.

02Docker Sandbox Setup

OAR runs inside an isolated Docker compose stack. The sandbox ensures nothing touches your host machine unless you explicitly allow it through the Airlock.

# Build and start all services
./bin/omnipotent up

# Verify containers are running
docker compose -f infra/docker/docker-compose.omnipotent.yml ps

03Verify the Runtime

Open the dashboard to confirm all 12 agent roles are registered and the memory tiers are online.

# Check agent status
./bin/omnipotent status

# Open the web dashboard (default: http://localhost:3000)
open http://localhost:3000

04Airlock Protocol Basics

The Airlock is OAR's zero-trust boundary between your local runtime and external federation peers. By default, every outbound connection is blocked until you grant explicit approval.

Key Concepts

Approve / Deny — every federation request goes through the Airlock UI.
SHA-256 Integrity — 43+ core files are hashed and verified on every startup.
Audit Trail — all approved and denied operations are logged permanently.

Next Steps

Tutorial — deep-dive into agent orchestration workflows.
How It Works — understand the 9-step self-correcting protocol.
Agents — explore all 12 specialized agent roles.