AtlasOS Platform Alpha

The fastest way to generate, validate, visualize and govern autonomous robot missions.

A production-grade web application that wraps AtlasOS Core into a complete product — mission planning, digital twin visualization, optimization comparison, and WitnessOS governance.

atlas.empirelabs.site (coming soon)

---

Stack

Layer	Technology
Backend	FastAPI (Python 3.12+)
Frontend	React 18 + TypeScript
Build	Vite
Styling	Tailwind CSS v4
Map	MapLibre GL JS

Quick Start

Prerequisites

• Python 3.12+
• Node.js 20+
• AtlasOS Core (atlasos package)

Install AtlasOS Core

pip install git+https://github.com/narko4u/atlasos.git

# For local development (recommended):
# git clone https://github.com/narko4u/atlasos.git ../atlasos
# pip install -e ../atlasos

Start Backend

cd backend
pip install -e .
uvicorn app.main:app --reload --port 8080

Start Frontend

cd frontend
npm install
npm run dev

Open http://localhost:5173 — the Vite proxy forwards /api/* to the backend.

Architecture

Browser
    │
React + TypeScript + MapLibre
    │  REST / WebSocket
    │
FastAPI  ←── atlasos (Python package)
    │
    ├─ Mission Planner
    ├─ Geometry Engine
    ├─ Capability Engine
    ├─ Mission Optimizer
    ├─ Digital Twin
    └─ WitnessOS Client

Rule: The UI never contains business logic. AtlasOS Core owns everything. The UI is just another client.

API

Method	Endpoint	Description
GET	/api/v1	Health check
POST	/api/v1/sites/validate	Detect field type, validate dimensions
POST	/api/v1/sites/geocode	Address → GPS lookup
POST	/api/v1/missions/generate	Run full AtlasOS pipeline
POST	/api/v1/missions/compare	Fastest vs Lowest Paint
GET	/api/v1/missions/{id}	Cached mission data
POST	/api/v1/missions/{id}/witnessos/check	Policy enforcement
GET	/api/v1/export/{id}/svg	SVG overlay download
GET	/api/v1/export/{id}/json	Mission data export
GET	/api/v1/export/{id}/receipt	WitnessOS evidence receipt

Roadmap

Version	Milestone	Status
v0.5	Digital Twin (Core)	✅ Complete
v0.6	Platform Alpha — Web UI	✅ Live
v0.7	Interactive Digital Twin + Playback	🔲 Next
v0.8	Physical ROS 2 Robot	🔲 Planned
v0.9	Multi-Site Mission Library	🔲 Planned
v1.0	Commercial Launch	🔲 Planned

Deployment

docker build -t atlas-platform .
docker run -p 8080:8080 atlas-platform

Then serve the frontend build from frontend/dist/ via nginx or similar.

---

Built by Empire Labs