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 healthupdate-checker— metadata onlycompositor-watchdog— fallback UIai-backend— AI HTTP serverfirst-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 daemonfirst-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: falseHub 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.