Skip to content

Lucas8448/asos

Repository files navigation

ASOS — Autonomous Swarm Orchestrator Sandbox

A hierarchical AI command sandbox that translates operator text intent into coordinated behavior across autonomous simulation assets.

Architecture

┌────────────────────────────────────────────────────────────┐
│                    Operator (Browser)                       │
│  ┌─────────┐ ┌──────┐ ┌───────┐ ┌───────┐ ┌────────────┐ │
│  │ Map     │ │Teams │ │Plan   │ │Explain│ │ Replay     │ │
│  │ (Live)  │ │Panel │ │Panel  │ │Panel  │ │ + Metrics  │ │
│  └────┬────┘ └──┬───┘ └──┬────┘ └──┬────┘ └─────┬──────┘ │
└───────┼─────────┼────────┼─────────┼────────────┼─────────┘
        │ WebSocket (single mux'd connection)      │
┌───────┼─────────┼────────┼─────────┼────────────┼─────────┐
│       ▼         ▼        ▼         ▼            ▼         │
│  ┌──────────┐  ┌────────────┐  ┌───────────────┐         │
│  │sim-engine│  │orchestrator│  │copilot-intent │         │
│  │ :8000    │  │ :8001      │  │ :8002         │         │
│  └────┬─────┘  └─────┬──────┘  └──────┬────────┘         │
│       │              │                │                   │
│       └──────────────┼────────────────┘                   │
│                      ▼                                    │
│              ┌──────────────┐                             │
│              │  Redpanda    │                             │
│              │  :19092      │                             │
│              └──────────────┘                             │
│              Topics: commands, events, telemetry,         │
│                      alerts, explanations                 │
└───────────────────────────────────────────────────────────┘

Quick Start

docker compose up -d
# Visit http://localhost:5173 (frontend)
# Visit http://localhost:8080 (Redpanda Console)

Services

Service Port Description
sim-engine 8000 World simulator + asset runtime
orchestrator 8001 Mission planner + team hierarchy
copilot-intent 8002 LLM intent parser + explainability
Redpanda 19092 Event backbone (Kafka-compatible)
Redpanda Console 8080 Redpanda management UI

Development

pnpm install        # Install TS dependencies
pnpm dev            # Start TS dev servers
make up             # Start all Docker services
make seed           # Load seed data
make test           # Run all tests

About

Autonomous Swarm Orchestrator Sandbox

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors