🌐 Website · 📚 Documentation · 🚀 Quickstart · 🗺️ Roadmap · 📝 Changelog

⚡ Public Alpha — a working, bootable Native WebOS prototype. VM-tested and booted on a Mac Mini Late 2012 in around 40 seconds. Ready for exploration.

🧠 Abstract

Samaris OS is a bootable operating system where the desktop experience is built entirely with web technologies — but runs as a first-class native environment inside a real OS, not inside a browser tab.

Linux underneath.
Web technologies on top.
Native OS behaviour in between.

This is not a website. Not a mockup. Not a Linux rice.

This is a working operating system that boots from a USB key, launches a full graphical desktop, runs native apps, connects to WiFi, persists sessions, and hosts a fully local AI assistant — all in around 5 GB for x86-64, or 10.68 GB for the universal x86-64 + ARM image.

And YES, it even runs DOOM.

📑 Table of Contents

• What Is Samaris OS?
• Videos
• Screenshots
• The Vision
• Architecture
• Key Capabilities
• Built-in Applications
• App Store & Wine
• Orbit AI
• Performance
• Download
• Try It
• What Samaris OS Is Not
• Built By
• License

🔥 What Is Samaris OS?

Samaris OS is a bootable operating environment that starts directly into a custom native desktop.

This is not a website.
Not a mockup.
Not a browser tab.
Not a Linux rice.

Samaris OS boots. It launches its own graphical experience. It runs a custom desktop shell. It opens apps. It manages windows. It persists sessions. It manages files. It runs system services. It talks to AI.

It behaves like a real operating environment.

Linux kernel → systemd → Node.js bridge → Rust accelerator → Electron shell → React desktop

Alpha One is the first public step.

🎬 Videos

Samaris OS Alpha One — Demo

Boot → desktop → apps → Orbit AI. See the full experience in action.

Samaris OS Alpha One — Proof of Boot

Mac Mini Late 2012 Intel · Boot → Onboarding → Desktop

🖼️ Screenshots

The Samaris desktop and lock screen — fullscreen Electron shell with glass-design UI.

Finder filesystem browser · System Settings · Orbit AI assistant

Peregrine web browser · Photos · Videos player

Music player · Notes · App Store with community apps

🌌 The Vision

Modern computing has become dependent on accounts, subscriptions, cloud lock-in, fragmented ecosystems, heavy desktop environments, and impersonal interfaces.

Samaris OS explores another direction.

A portable operating environment that boots from a USB key, opens into its own fullscreen desktop, keeps your session persistent across reboots, and gives you a beautiful, local-first workspace — all running on commodity hardware.

No mandatory cloud.
No forced account.
No telemetry-first design.
No bloated ecosystem.

Your desktop. Your files. Your apps. Your environment. In your pocket.

🏗️ Architecture

┌──────────────────────────────────────────────────────────────────┐
│ LAYER 6: APPLICATIONS                                            │
│ 26 built-in apps · Wine · Orbit AI · Web Apps · jsdos            │
├──────────────────────────────────────────────────────────────────┤
│ LAYER 5: DESKTOP SHELL                                           │
│ Electron 28 · React 18 FSD · Window Manager · AirBar · Dock      │
├──────────────────────────────────────────────────────────────────┤
│ LAYER 4: KERNEL A — Node.js (:9999)                              │
│ 33 system services · WebSocket router · Auth · IPC · Volt Unifier│
├──────────────────────────────────────────────────────────────────┤
│ LAYER 3: VOLT RUNTIME — Rust Daemons (SBP binary protocol)       │
│ VRM (RAM) · VGM (GPU) · VUM (USB) · DWP (Scheduler) · ASC (HW)   │
│                         Tesseract Engine (Kernel B)              │
├──────────────────────────────────────────────────────────────────┤
│ LAYER 2: INIT & BOOT                                             │
│ systemd · Plymouth splash · OverlayFS · Live filesystem          │
├──────────────────────────────────────────────────────────────────┤
│ LAYER 1: DEBIAN TRIXIE BASE                                      │
│ Linux 6.12 · WiFi/BT/GPU firmware · X.Org · NetworkManager       │
└──────────────────────────────────────────────────────────────────┘

The operating system is built from a modular ISO pipeline:

debootstrap → Debian packages → module overlays → Rust daemons → Node.js kernel → Electron shell → React desktop

All compressed into a single SquashFS filesystem inside a bootable ISO.

Full architecture documentation →

✨ Key Capabilities

🚀 1. Native Boot — Real OS, Real Hardware

From a USB key or ISO, Samaris boots directly into its own fullscreen desktop.

No cloud streaming.
No virtual machine required.
No browser dependency.

The live filesystem uses OverlayFS for persistence, allowing the user session to survive reboots.

Boot time: around 47 seconds in QEMU
Hardware boot: around 40 seconds on Mac Mini Late 2012 Intel

🧬 2. Dual-Kernel Architecture

The two kernels communicate through Volt Unifier, which bridges desktop events to SBP binary messages through bridge modules and IPC clients.

Kernel A → · Kernel B → · Volt Unifier →

🦀 3. Six Native Rust Daemons

Every major system resource is managed by a dedicated Rust daemon communicating through the SBP binary protocol.

All daemons → · SBP Protocol →

🖥️ 4. Desktop Shell — Electron + React 18

The desktop is a fullscreen React application rendered by Electron.

It provides:

• 🪟 Window Manager — z-order, resizing, snapping, animations, close guards
• 🧭 Dock — application launcher with running indicators
• 📡 AirBar — system status panel for clock, WiFi, battery, and volume
• 🔎 Spotlight Search — Cmd/Ctrl + Space global search
• 🎨 Theme System — light/dark mode, accent colours, density, font scale
• 🗂️ Desktop Icons — draggable organised grid
• 🔒 Lock Screen — authentication overlay

Desktop architecture → · UI architecture → · Window system →

💾 5. Session Persistence

All user data survives reboots:

• files
• settings
• app state
• credentials
• session metadata

The live system uses an OverlayFS filesystem, while sessions are tracked by sessionFeaturesService.

Encrypted user storage is managed through:

.volt/users/

📦 Built-in Applications

26 applications ship with Alpha One, organised into four categories.

🧰 System & Desktop

🌐 Network & Security

🎵 Media & Productivity

🕹️ Compatibility

📦 App Store & Wine — Extend Samaris OS

🛒 Samaris App Store

The App Store is the simplest way to grow your system. It connects directly to GitHub repositories that publish Samaris-compatible apps.

• One-click install from the store interface
• Community-driven — anyone can host an app on GitHub
• No terminal, no dependency hunting — the store handles cloning, building, and integration
• Fast iteration — install apps as quickly as you would preview a React component

The store lists categories such as utilities, media, developer tools, and games. Future versions will support automatic updates.

🍷 Wine — Windows Compatibility

Wine is integrated at the system level, allowing Samaris OS to run Windows .exe applications alongside native Samaris apps.

• Launch .exe files directly from Finder or the terminal
• Seamless window management — Windows apps resize, snap, and focus like native apps
• No virtual machine required — Wine runs natively on Samaris OS
• Compatibility with classic and productivity apps — older Windows software, utilities, and some games

💡 Note: Wine is a compatibility layer, not an emulator. Performance and compatibility vary by application.

Why both?

Together, they make Samaris OS a practical daily environment for exploration without locking the user into a single ecosystem.

App Store docs → · Wine launcher docs → · Adding an app to the store →

🧠 Orbit AI — Your Local Brain

No cloud. No accounts. No telemetry. No phone-home.

Samaris ships with a complete local AI stack running entirely on your hardware, powered by llama.cpp with GPU acceleration through Metal, CUDA, or Vulkan.

Voice Mode

Press mic → speak → Whisper transcribes → Qwen3 generates → OuteTTS speaks → loop

Orbit can be interrupted mid-sentence. It stops and responds.

Orbit can be summoned with:

Cmd/Ctrl + Space

It operates with burst priority through the DWP scheduler — a dedicated 100 ms window with 75% worker reservation ensures responsive AI even under load.

Orbit AI docs → · AI Stack →

📊 Performance

Full benchmark report → · ISO size breakdown →

⬇️ Download

Two ISO variants · Free · No account · No telemetry

Download from Samaris →

ℹ️ The Universal ISO is larger because it ships two complete SquashFS filesystems in a single image: one for x86_64 and one for aarch64.

🧪 Try It

1. Download

Get the ISO from:

https://samaris.tech

2. Run in QEMU or a Virtual Machine

qemu-system-x86_64 \
  -m 4096 \
  -smp 4 \
  -cdrom Samaris-OS-Alpha-One-RC.iso \
  -vga virtio \
  -display cocoa

3. Explore

• 🖥️ Desktop — fullscreen shell, dock, window management
• 🗂️ Finder — filesystem browser
• ⚙️ Settings — theme, appearance, security
• 🧠 Orbit AI — Cmd/Ctrl + Space to launch the assistant
• 🦅 Peregrine — built-in web browser
• 🛒 App Store — install apps from GitHub

System Requirements

Quickstart → · Installing the ISO → · First Boot →

❌ What Samaris OS Is Not

Samaris OS Alpha One is:

• not a finished OS
• not a Windows replacement
• not a macOS replacement
• not a daily-driver recommendation
• not production-ready
• not hardware-certified
• not a traditional Linux desktop distribution
• not open source

It is a serious experimental operating system prototype.

⚠️ Known Issues (Alpha One)

• WiFi: works on some hardware, not all. Firmware missing for certain chips.
• App Store: works with standard React/Vite GitHub repos. Edge cases in progress.
• Wine: present but not extensively tested.
• Peregrine downloads: occasional bugs under investigation.

Alpha Two will address all of the above. And more.

👨‍💻 Built By

Khaled Ben Taieb — OS Architect

• PharmD, MBA
• Built solo
• Zero budget
• AI-assisted development
• Built in around 1 month
• Development machine: MacBook Air M3

"Computers are supposed to be fun. That's why I made you this OS; it's tailored to your taste. Love you, dad."

⚖️ License

Samaris Public License — SPL v3.0
Source-available. Not open source in the OSI/FSF sense.

Upstream open-source components — Linux kernel, GRUB, Chromium, Node.js, React, systemd, and others — retain their respective licenses.

Commercial use, enterprise deployment, and investor evaluation require a separate written license.

Full license details →

samaris.tech · GitHub · contact.samaris.os@gmail.com

Some OSes manage windows. Samaris reimagines them.

Samaris OS — The Native WebOS
Boot it. Build the future with it.

Copyright © 2026 Khaled Ben Taieb