IRAM OS 🌌

The Autonomous Agentic Desktop Operating System

A high-performance Linux operating system powered by Hyprland, featuring sharp geometric tiling, zero-restart live theme switching, studio-grade PipeWire audio routing, automated multi-display intelligence, and a deeply integrated autonomous AI toolchain.

📸 Desktop Visual Showcase

3D Multi-Agent Swarm Topology (Three.js) iram agent graph	Hardware CAD & Biomolecule Inspector iram 3d <model.stl>
Zero-Restart Theme Switcher (18 Curated Palettes & Live Preview Grid) iram theme

📖 About IRAM OS

What is IRAM OS?

IRAM OS is an independent, turnkey 64-bit Linux operating system distribution engineered from the ground up for modern developers, power users, and AI practitioners. It bridges the gap between ultra-fluid Wayland dynamic tiling and autonomous desktop computing, providing a cohesive environment where the user interface, system hardware, and local/cloud AI agents collaborate seamlessly.

The Vision: The Interface Becomes the API

Traditional operating systems treat artificial intelligence as a passive side-panel chatbot. IRAM OS fundamentally rethinks the desktop by making the system itself agent-controllable:

• Agents can observe and query: Window hierarchy, active workspaces, audio routing topology, system telemetry, and clipboard history.
• Agents can act: Dispatch windows, switch themes, execute sandboxed code-as-action snippets, and diagnose failed services without human friction.
• Zero Configuration Headaches: Multi-monitor overlaps, audio sink stalls, and manual daemon configuration are solved out of the box with intelligent automation.

Project Heritage & Evolution

IRAM OS was originally inspired by the desktop concept of Omarchy authored by David Heinemeier Hansson (DHH). Recognizing the demand for a turnkey, production-grade operating system with native dual-monitor resilience, systemd service supervision, and a full-stack autonomous AI runtime, the project was completely re-architected into an independent distribution:

1. Desktop Engine: Engineered sharp 90° geometry (rounding = 0), a flush edge-to-edge status bar, and custom dual-display collision avoidance (iram-displays-gui).
2. Audio Stack: Built studio-grade PipeWire/WirePlumber priority rules with instant 1-key output cycling across analog lines, HDMI converters, and Bluetooth.
3. Agentic Layer: Integrated embedded vector memory (Qdrant), temporal knowledge graphs (Graphiti), web scrapers (Crawl4AI), document parsers (Docling), code executors (smolagents), and long-running cyclic loops (LangGraph).
4. Distribution Pipeline: Built a hybrid UEFI/BIOS bootable Live ISO compiler that produces flashable, autologin media with bare-metal installer capability.

🏛️ Core Architecture

┌────────────────────────────────────────────────────────────────────────┐
│                               IRAM OS                                  │
├────────────────────────────────────────────────────────────────────────┤
│  AUTONOMOUS AGENTIC RUNTIME                                            │
│  FastMCP ── Qdrant ── Graphiti ── Crawl4AI ── Docling ── LangGraph    │
├────────────────────────────────────────────────────────────────────────┤
│  WAYLAND DESKTOP ENVIRONMENT                                          │
│  Hyprland (0px Sharp) ── Waybar (Flush) ── Rofi/Wofi ── Mako ── Swaybg │
├────────────────────────────────────────────────────────────────────────┤
│  CREATIVE PRODUCTIVITY & SERVICES                                      │
│  Storytold Craft Suite ── PipeWire ── 18-Theme Sync ── Wayland OCR     │
├────────────────────────────────────────────────────────────────────────┤
│  LINUX KERNEL & HARDWARE ABSTRACTION                                  │
│  Debian/GNU Core ── systemd Daemons ── Multi-Monitor GPU Pipeline      │
└────────────────────────────────────────────────────────────────────────┘

1. Compositor & Window Mechanics

• Compositor: Hyprland with strict rectangular geometry (rounding = 0), compact 2px inner window gaps, 4px outer margins, and fluid dwindle layouts.
• Status Bar: Waybar designed edge-to-edge with workspace tabs, CPU/RAM telemetry, active audio sink indicators, weather, and power controls.
• Application Launcher: Enhanced launcher with single-instance instant toggle (iram-app-launcher) and fuzzy keyboard navigation.

2. Multi-Display Intelligence

• Automatically detects connected monitors, television displays, and auxiliary screens.
• Eliminates common 0x0 geometry overlapping bugs by calculating offsets dynamically.
• Ships with a native GTK display management panel (iram-displays-gui) to set refresh rates, orientations, and custom resolutions persistently.

3. Studio-Grade Audio Subsystem

• Powered by PipeWire and WirePlumber.
• Automatic HDMI audio converter priority rules to prevent display sleeping stalls.
• Instant 1-touch output toggle shortcut (Super + Shift + A) that switches streams live across Motherboard 3.5mm jacks, HDMI TV outputs, USB interfaces, and Bluetooth headsets.

4. Zero-Restart Theming Engine (18 Modern Themes)

• 18 hand-curated color palettes: Tokyo Storm, Catppuccin Mocha, Nord Frost, Gruvbox, Everforest, Rose Pine Moon, Dracula, Solarized Dark, Cyberpunk Neon, Oxocarbon, Monokai Pro, Synthwave '84, Kanagawa Wave, Vesper, Ayu Mirage, Material Ocean, Aura Dark, and One Dark.
• Switching themes (Super + Ctrl + Shift + Space or iram theme) instantly updates Hyprland borders, Waybar styling, launcher palettes, terminal colors, and notifications simultaneously with zero session restarts.

5. Storytold Craft Creative Suite

• Integrated pure-Rust creative desktop applications replacing proprietary suites: PhotoCraft (Photoshop alternative), VectorCraft (Illustrator alternative), FilmCraft (Premiere alternative), SoundCraft (DAW alternative), LightCraft (Lightroom alternative), CADCraft (AutoCAD alternative), and WordCraft (Word alternative).
• Launched via the unified command iram craft [app] or the artcraft-launcher hub.

🤖 The Agentic AI Toolchain

IRAM OS is the first desktop operating system to embed a complete, production-grade autonomous agentic stack directly into the system shell:

🚀 Installation

Method 1: Automated Script (Recommended)

Run the automated installer on an existing Linux installation:

# Clone repository
git clone https://github.com/apravint/iram-os.git
cd iram-os

# Launch installer
chmod +x install.sh
./install.sh

Or run directly via curl:

curl -fsSL https://raw.githubusercontent.com/apravint/iram-os/main/install.sh | bash

Launching the Desktop:

1. Log out of your current session.
2. At the display manager login screen (GDM, SDDM, or LightDM), select IRAM OS (or Hyprland).
3. Log in to start the session.

Method 2: Bootable Live ISO

A bootable hybrid UEFI/BIOS ISO is available for bare-metal deployment and testing:

1. Download the latest .iso image from GitHub Releases.
2. Flash to a USB drive using Ventoy, BalenaEtcher, or dd:

   sudo dd if=iram-os-26.10-amd64.iso of=/dev/sdX bs=4M status=progress oflag=sync
   

3. Boot the USB drive and select Start IRAM OS Live.
   • Username: iram
   • Password: iram (Passwordless sudo enabled)

⌨️ Keyboard Shortcuts

General & Applications

Window & Workspace Tiling

Displays, Audio & Hardware

Themes & Status Bar

Screenshots, Recording & OCR

🛠️ CLI Utilities Reference

All tools are located in bin/ and automatically installed to ~/.local/bin/ and /usr/local/bin/:

👑 Unified Command Center

Desktop & Display Management

Audio, Media & Screen Tools

Creative Productivity (Storytold Craft Suite)

Theming Subsystem

Autonomous Agentic AI Toolchain

System Health & Maintenance

⚙️ Configuration Paths

All configuration files adhere to standard XDG specifications in ~/.config/:

~/.config/
├── hypr/
│   ├── hyprland.conf          # Compositor layout, gaps, keybindings, and window rules
│   └── cursor.conf            # Active cursor theme and size
├── waybar/
│   ├── config.jsonc           # Bar modules, ordering, and exec hooks
│   ├── style.css              # Waybar CSS layout and styling
│   └── colors.css             # Active theme color variables
├── wofi/
│   └── style.css              # Application launcher appearance
├── mako/
│   └── config                 # Desktop notification styling
└── wireplumber/
    └── wireplumber.conf.d/
        └── 50-hdmi-priority.conf # Audio hardware prioritization rules

🌐 Modular Ecosystem Repositories

IRAM OS features modular, standalone open-source companion projects maintained under the same vision:

📚 Developer Knowledge Bases & Blueprints

Preloaded in docs/ and ~/resources/ for both human developers and autonomous AI agents:

• Autonomous Web Application Stack (JSON): 10 open-source repositories to build, deploy, and operate production web apps with foundation models.
• AI Engineering Lab Stack (JSON): 10 open-source repositories for synthetic data generation, specialist fleet fine-tuning, standardized evaluation, and model serving.
• Design Engineering Toolkit (JSON): 23 tools combining the Design Engineer Essential Toolkit (3D, canvas, motion) with 2026 rapid shipping accelerators.
• UI Component Libraries (JSON): 10 premier web animation and modern React component systems.

🏗️ Building the ISO from Source

To compile the bootable Live ISO from source:

# Clone the repository
git clone https://github.com/apravint/iram-os.git
cd iram-os

# Run ISO build engine (requires root)
sudo bash build/build-iso.sh

The build engine outputs the final ISO and SHA-256 checksum in out/.

🧹 Uninstallation

To restore your original configurations and remove installed scripts:

cd iram-os
./uninstall.sh

⚖️ License & Trademarks

This project is open-source software licensed under the MIT License.

Legal & Trademark Notices

• IRAM OS: IRAM OS is an independent open-source desktop operating system project maintained by Ayyappa Pravin.
• Ubuntu: Ubuntu is a registered trademark of Canonical Ltd. IRAM OS is an independent project and is not affiliated with, sponsored by, or endorsed by Canonical Ltd.
• Third-Party Trademarks: All other trademarks, service marks, trade names, product names, and logos appearing in this repository are the property of their respective owners. Use of these names, logos, and brands is for identification purposes only and does not imply endorsement or affiliation.

❤️ Acknowledgments & Special Thanks

IRAM OS stands on the shoulders of brilliant open-source pioneers, communities, and projects:

• Canonical & The Ubuntu Community: For providing the rock-solid Debian-based package ecosystem, hardware drivers, and long-term release foundations that empower our system binaries and live ISO media.
• David Heinemeier Hansson (DHH) & the Omarchy Community: For the foundational desktop concept and aesthetic inspiration that sparked the initial journey.
• Vaxry and the Hyprland Team: For engineering the fluid, dynamic Wayland compositor that powers this desktop.
• Alexays and the Waybar Contributors: For building the modular, flexible status bar framework.
• Wim Taymans, George Kiagiadakis, and the PipeWire / WirePlumber Teams: For creating studio-grade, glitch-free audio routing on Linux.
• The Model Context Protocol (FastMCP) Team: For creating the universal protocol bridging AI models and desktop environments.
• The Qdrant Team: For their embedded, vector search engine.
• The Zep / Graphiti Team: For temporal knowledge graphs that give AI persistent project memory.
• The Crawl4AI Team: For high-speed, LLM-friendly web scraping and content extraction.
• The Docling Team: For document parsing capabilities across PDFs and office documents.
• The Hugging Face / smolagents Team: For code-as-action AST sandboxing.
• Harrison Chase & the LangGraph Team: For resilient, stateful cyclical agent workflows.
• The Arize Phoenix Team: For telemetry, traces, and AI observability.
• The Designers of the 18 Curated Themes: The artists and creators of Tokyo Night, Catppuccin, Nord, Gruvbox, Everforest, Rosé Pine, Dracula, and Kanagawa.
• Every Community Supporter & Tester: To all early testers, stargazers, and contributors who tested ISO builds, reported bugs, and helped refine IRAM OS into what it is today.