OOrion OS

Whitepaper · Version 1.0

Orion OS: An AI-Native, Minimal, Modular Operating System

A complete technical and conceptual overview of the platform.

Abstract

Orion OS is a lightweight, modular, AI-integrated operating system designed to be fast, understandable, and extensible. It introduces a modern architecture built around a catalog-driven application model, a unified AI intent router, and a clean separation between system services and user-facing applications. Orion OS supports both user-friendly and developer-friendly editions and is capable of self-hosting its own development environment.

This whitepaper outlines the system's architecture, boot pipeline, service model, application framework, and roadmap.

1. Introduction

Traditional operating systems have grown increasingly complex, opaque, and difficult to modify. Orion OS takes the opposite approach: it is intentionally minimal, modular, and transparent. It is designed for:

  • fast boot
  • predictable behavior
  • easy extension
  • AI-native interaction
  • self-hosting development

The system is built on Alpine Linux, uses a custom init, and ships as a UEFI-bootable ISO.

2. Design Principles

2.1 Minimalism

Every component is small, isolated, and understandable. No monolithic desktop environment, no heavy init system, no unnecessary background processes.

2.2 Modularity

Apps and services are independent Rust binaries. The OS is a collection of small, composable units.

2.3 AI-Native

Natural-language commands are first-class citizens. The AI backend and AI UI are core system components.

2.4 Self-Hosting

The developer edition includes a workspace and toolchain, enabling the OS to build itself from within.

2.5 Edition-Aware

One root filesystem supports two personalities:

  • User Edition — simple, clean, minimal
  • Developer Edition — full toolchain, workspace, dev tools

3. System Architecture

3.1 Boot Pipeline

  • UEFI firmware
  • Kernel
  • init.sh (PID 1)
  • Core services
  • Compositor
  • First-boot wizard or session launcher
  • Hub or AI UI

3.2 Core Services

  • net-status — network health
  • update-checker — metadata only
  • compositor-watchdog — fallback UI
  • ai-backend — AI HTTP server
  • first-bootd — wizard backend

3.3 Application Layer

Apps are defined in catalog/apps.yaml and launched via SAL or Hub.

System apps include:

  • About
  • Settings
  • Log Viewer
  • Doc Editor
  • Image Editor
  • Browser
  • Internet Hub

3.4 AI Intent Router

Maps natural-language phrases to SAL actions. Centralized in ai/backend/src/intent.rs.

4. Editions

Developer Edition

  • Workspace at /home/user/src/os
  • Git, build tools, Rust, code wrapper
  • Dev intents and Hub tiles

User Edition

  • No workspace
  • No dev tools
  • Simplified Hub

Edition stored in /etc/myos/edition.

5. First-Boot Wizard

Two-component design:

  • first-bootd — backend daemon
  • first-boot — UI

Configures:

  • edition
  • username
  • theme

Runs once, then exits permanently.

6. Catalog-Driven Application Model

Apps are defined declaratively:

- id: about
  name: "About This OS"
  binary: "about"
  category: "system"
  install: true
  hidden: false

Hub resolves tiles by catalog id.

7. Roadmap

v1 — Foundation

Minimal OS, AI integration, first-boot wizard, editions.

v2 — Experience Layer

Themes, notifications, improved Hub, graphical installer.

v3 — Platform Layer

ARM64, OTA updates, app store, permissions model.

8. Conclusion

Orion OS is a new kind of operating system: small, modular, AI-native, and self-hosting. It provides a clean foundation for future AI-driven computing environments.