Skip to content
Mardon-programmPublic

About

Custom AI-centric hybrid operating system featuring a C-based Linux kernel, custom init (PID 1), framebuffer window manager (airo-wm), Python FastAPI backend (Lumira Core), and a feature-rich Web SPA desktop client.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Origin-X

Custom AI-centric operating system with framebuffer desktop, native C applications, and AI-powered backend.

Linux kernel 7.1.8 + custom init (PID 1) + custom shell + framebuffer window manager (airo-wm) + 35+ graphics primitives + Python FastAPI backend with 98 API endpoints + browser-based SPA client with 21 applications.

Architecture

┌─────────────────────────────────────────────────────┐
│                    Web Client (SPA)                  │
│              21 apps · WebSocket · JWT auth          │
├─────────────────────────────────────────────────────┤
│               Lumira Core (Python/FastAPI)           │
│    98 endpoints · Sandbox · Memory/RAG · Voice      │
├─────────────────────────────────────────────────────┤
│              Origin-X OS (C · Static Linux)          │
│  airo-wm · airo-term · airo-fm · edit · lumira-ai   │
│  libfb (35+ primitives) · Smart-Casual design       │
├─────────────────────────────────────────────────────┤
│          Linux Kernel 7.1.8 · GRUB Bootloader        │
│    ATA · DRM · virtio · e1000 · framebuffer          │
└─────────────────────────────────────────────────────┘

Features

OS Layer (C)

  • init — PID 1 service manager, zombie reaper, shutdown/reboot
  • originx-sh — POSIX shell with pipelines, redirects, job control, tab-completion
  • originx-login — SHA-256 PBKDF2 authentication
  • airo-wm — Framebuffer window manager: drag/resize, 4 workspaces, taskbar, app launcher, screenshots
  • airo-term — PTY terminal emulator with ANSI colors
  • airo-fm — Dual-pane file manager
  • edit — Text editor (10k lines, line numbers)
  • airo-calc — Calculator
  • airo-sys — System monitor
  • libfb — Double-buffered framebuffer library: easing, clipboard, 35+ drawing primitives

Backend (Python)

  • 98 REST + WebSocket endpoints
  • Security: PBKDF2-SHA256 (200k iterations), JWT sessions, admin/user roles
  • Sandbox: Docker hardening or POSIX fallback (cap-drop, no-new-privs, rlimits)
  • Memory/RAG: TF-IDF offline engine, optional ChromaDB
  • Self-Coding: AI-powered patch generation with sandbox testing
  • Ghost Mode: Anti-theft (BLE key, disk lock, log wipe, tunnel)
  • Voice: TTS/STT with Whisper integration
  • Screen: Screenshot + LLM vision analysis
  • Hardware: Bluetooth/USB/GPIO polling with trigger actions
  • OTA Updates: Git-pull with HMAC-SHA256 manifest verification

Web Client (JavaScript)

  • Desktop window manager in browser (draggable windows, taskbar, start menu)
  • 21 applications: Lumira AI, Terminal, Browser, Files, Store, Cyber Dashboard, Settings, and more
  • PWA support with manifest

Quick Start

Prerequisites

  • WSL (Alpine Linux for building, Arch Linux for kernel)
  • QEMU (Windows: C:\Program Files\qemu\qemu-system-x86_64.exe)

Build & Run

# Build all C binaries (incremental)
cd os && make

# Build initramfs
make initramfs

# Build GRUB bootable disk image
bash build/build_grub_disk.sh

# Launch (Windows)
launch_originx.bat

Run Lumira Core (Backend)

pip install fastapi uvicorn
python run.py
# Backend at http://localhost:8899

Connect VNC

  • Launch with launch_originx.bat
  • Connect TightVNC Viewer to 127.0.0.1:5901

Tech Stack

Layer Technology
Kernel Linux 7.1.8 (custom config)
Bootloader GRUB 2.14 (BIOS/MBR)
Init Custom C (PID 1 service manager)
Shell Custom C (POSIX-ish)
Desktop Custom C framebuffer WM (airo-wm)
Graphics libfb (Linux fbdev, double-buffered)
Backend Python 3.12 + FastAPI + WebSocket
Auth PBKDF2-SHA256 + JWT bearer tokens
Client Vanilla JS SPA (no framework)
Networking e1000 + user-mode NAT + DHCP
Virtualization QEMU 11.1.0

Project Structure

Origin-X/
├── core/              # Python backend (Lumira Core)
│   ├── daemon.py      # FastAPI app, 98 endpoints
│   ├── security.py    # Auth, PBKDF2, JWT
│   ├── sandbox.py     # Docker/POSIX sandboxing
│   ├── intent_router.py  # NLU intent engine
│   └── ...            # 27 Python modules
├── client/            # Web SPA client
│   ├── app.js         # 21 apps, window manager
│   ├── styles.css     # Smart-Casual design
│   └── index.html     # Entry point
├── os/                # C operating system
│   ├── init/          # PID 1 + login
│   ├── shell/         # originx-sh
│   ├── apps/          # Desktop applications
│   │   ├── libfb/     # Framebuffer library (35+ primitives)
│   │   ├── airo-wm/   # Window manager
│   │   ├── airo-term/ # Terminal emulator
│   │   ├── airo-fm/   # File manager
│   │   └── ...        # calc, edit, browser, sys, lumira-ai
│   ├── build/         # Build scripts, GRUB, initramfs
│   └── Makefile       # Incremental build system
├── tools/             # CLI utilities
├── dist/              # Distribution (WSL rootfs)
├── run.py             # Entry point
└── LICENSE            # MIT

API Reference

See API documentation for full endpoint reference.

Core endpoints:

  • POST /api/auth/login — Authenticate
  • GET /api/system — System info
  • POST /api/terminal — Execute commands
  • POST /api/cyber/scan — Security scan
  • GET /api/memory — RAG memory
  • POST /api/sandbox/run — Sandboxed execution
  • WS /ws/chat — Real-time chat

License

MIT License — see LICENSE

About

Custom AI-centric hybrid operating system featuring a C-based Linux kernel, custom init (PID 1), framebuffer window manager (airo-wm), Python FastAPI backend (Lumira Core), and a feature-rich Web SPA desktop client.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages