APEX (Autonomous Physical-Digital Ecosystem) is a multi-module automation stack that bridges the gap between high-level AI reasoning and low-level physical hardware control. It combines an AI terminal runtime, a real-time web dashboard, hardware firmware, and electronics design assets into a unified repository.
| Module | Purpose | README |
|---|---|---|
| Core | Software runtime layer (CLI + RAM) | Core/README.md |
| Core/CLI | Terminal AI runtime and orchestration engine | Core/CLI/README.md |
| Core/RAM | Next.js dashboard + knowledge base | Core/RAM/README.md |
| MicroMax | Hardware execution layer | MicroMax/README.md |
| MicroMax/OS | PlatformIO firmware for Uno + RP2040 | MicroMax/OS/README.md |
| MicroMax/OS Client | Browser/Rust-based control + flashing helper | MicroMax/OS Client/README.md |
| IOT | KiCad schematics + PCB layout | IOT/README.md |
| conductor | Product context, tracks, and workflow docs | conductor/README.md |
git clone <repo-url> APEX
cd APEXcd .\Core\RAM
npm install
npm run devcd ..\..\MicroMax\OS
platformio run -e uno
platformio run -e pico# Core/RAM
cd .\Core\RAM
npm run dev
npm run build
npm run lint
# Core/CLI
cd ..\CLI
bun run dev
bun run build
# MicroMax firmware
cd ..\..\MicroMax\OS
platformio run -e uno
platformio run -e pico
platformio run -e uno -t upload --upload-port COM4
# MicroMax OS Client (Rust server)
cd "..\OS Client"
cargo run- Architecture overview:
ARCHITECTURE.md - ASP v2.0 specification:
SPEC_ASP_V2.md - Master setup guide:
MASTER_SETUP_GUIDE.md - Node docs:
docs/MicroMax/DOCS.md,docs/MiniMax/DOCS.md,docs/MegaMax/DOCS.md - Agent capability notes:
AGENT.md - Workflow and planning system:
conductor/index.md - Conductor module guide:
conductor/README.md