OMERTAOS

Hybrid Agent Operating System:

• Python Control Plane (AI orchestration, governance, APIs)
• Rust Runtime Daemon (OS isolation, sandboxed execution, command/runtime boundary)

Quick Install

git clone https://github.com/Hamedghz/OMERTAOS.git
cd OMERTAOS
./quick-install.sh

Alternative local development startup:

docker compose -f docker-compose.local.yml up -d

Runtime Boundary

Python must delegate OS-level execution to runtime daemon via runtime client:

• target canonical client: control/runtime/
• gRPC contract: shared/proto/runtime.proto
• Rust daemon: runtime-daemon/

Canonical Planes

• control/ orchestration, scheduling, governance and APIs
• runtime-daemon/ privileged execution and sandbox enforcement
• data/ persistence, RAG, memory and adapters
• registry/ agent, model and prompt metadata
• policies/ policy definitions and evaluator interfaces
• schemas/ source contracts; shared/ generated clients and stable primitives

The former Python kernel/, control-plane/, rust-runtime/, database/, db/, root models/, and deployment copies are migration-era paths. Do not add new feature behavior to them.

Redesign and recovery

• Capability audit
• Canonical design
• Capability recovery plan
• ADR 0001: canonical ownership

Local Endpoints

• Console: http://localhost:3000
• Control: http://localhost:8000
• Gateway: http://localhost:8080
• Runtime daemon (gRPC default): 127.0.0.1:50051