ApexOS Hybrid Edition

Virtual operating system in the browser — decoupled core + HexaDE desktop environment.

Architecture

static/                 ← Desktop Environment (HexaDE)
  css/hexade.css
  js/apex-host.js       ← WebSocket / session bridge
  js/hexade-de.js       ← Deskbar, windows, apps, context menu
  index.html

src/                    ← OS core (no UI chrome)
  api/server.py         ← REST + WebSocket only
  core/                 ← kernel, scheduler, sudo
  filesystem/           ← VFS
  auth/                 ← login

Swap or fork the DE under static/ without touching the kernel.

Quick start

python -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate
pip install -r requirements.txt
python run.py

Open http://127.0.0.1:8000

User	Password
root	password
guest	guest

Features

• HexaDE Deskbar (top): app menu, window list, calendar, USB/BT when available, logoff
• Context menu on desktop and icons
• Terminal with sudo (15 min elevation, red titlebar)
• Task Manager with privilege gates
• .apx packages + permission gatekeeper
• Web APIs: network status, WebUSB, Web Bluetooth
• Wasm Test: validates WebAssembly.instantiate with a minimal module
• Session restore via sessionStorage

Shell

help | sysinfo | ls cd cat write mkdir rm
sudo <cmd> | apx list | apx remove <id> | perms
lsusb | bluetooth scan | network

Packages

python tools/apx_packager.py --src ./my_app --out ./dist/my.apx \
  --name "My App" --id com.example.app --perms hardware.network.read

Samples: packages/hello-world.apx, packages/media-player.apx

Documentation

Doc	Path
Wiki home	docs/wiki/Home.md
Architecture	docs/ARCHITECTURE.md
Getting started	docs/wiki/Getting-Started.md

License

MIT — see LICENSE.