Ubuntu 26.10 ยท Hyprland 0.56 ยท PipeWire Active
Operating System Architecture

IRAM OS & Sovereign Agentic Stack

IRAM OS is an independent, turnkey 64-bit Linux distribution engineered on Ubuntu 26.10 and Hyprland 0.56. It unifies autonomous AI agent swarms, the 11-app Storytold creative suite, and the Universal Film & Video Engine into a zero-latency, high-performance desktop.

49
Curated Themes
11
Creative Apps
12
Video Pipelines
28+
FastMCP OS Tools
98%
BM25 Compression

๐Ÿ’ป Interactive CLI Terminal Simulator

Click any command chip below to preview real formatted terminal outputs from the unified iram CLI dispatcher:

apravint@iram-os: ~ (Hyprland / foot)
$ iram info Operating System: IRAM OS (Ubuntu 26.10 Sovereign Edition) Linux Kernel: 7.3.0-9-generic (x86_64) Compositor: Hyprland 0.56.2 (Wayland protocol) Active Theme: Tokyo Storm (Dynamic ALPORA Sub-100ms) Creative Suite: Storytold Craft Ready (11 Rust native apps) Video Studio: iram-video 1080p/4K Cinema & OpenMontage Ready FastMCP Server: Active on port :8991 (28 native tools) Default Agent: Google Antigravity CLI (agy) & OpenRig Swarm
Try Commands:

Core Subsystem Hierarchy

๐ŸชŸ Compositor
Hyprland 0.56 & Waybar
0px geometric tiling, acrylic glassmorphism, duplicate keybind linter, and dedicated AI modifier space.
๐Ÿ–ฅ๏ธ Protocol
FastMCP Linux Desktop
PyPI v0.1.0 & Glama Grade-A certified Model Context Protocol server exposing 28+ native OS control tools.
๐ŸŽฌ Media
Universal Video Engine
1080p/4K real documentary generator with OpenMontage 12-pipeline agentic directing and Remotion React renderers.
๐ŸŽจ Creative
Storytold Craft Suite
11 high-throughput open-source Rust applications replacing Adobe Creative Cloud and Microsoft Office.
๐ŸŒˆ Theming
ALPORA Theme Studio
49 curated color palettes with 24-hour circadian timeline and zero-restart live reload across all desktop apps.
๐Ÿ“ก Kernel
Multi-WAN Dual Wi-Fi
Aggregates PCIe internal and USB external wireless adapters via Equal-Cost Multi-Path policy routing.
Model Context Protocol

FastMCP Linux Desktop Control Server

The fastmcp-linux-desktop daemon provides high-performance JSON-RPC 2.0 Model Context Protocol tools for AI coding assistants (Claude Desktop, Cursor, Google Antigravity, OpenRig, Windsurf).

PyPI Version Glama Score Glama Card MIT License
BASH CLI Installation
pip install fastmcp-linux-desktop
fastmcp-linux-desktop --sse --port 8991

๐Ÿงช Interactive FastMCP Tool Playground

Select any of the 28 native system tools below to simulate the JSON-RPC execution payload:

// Select a tool above and click "Simulate JSON-RPC Call" to view the live schema payload

Catalog of 28 Native OS Tools

CategoryTool NameTier / BehaviorFunction Payload
Window Mgmtget_windows()Read-OnlyEnumerate all active clients, geometry, and workspaces
Window Mgmtfocus_window(target)IdempotentFocus client by title substring, class, or hex address
Window Mgmtdispatch_hyprland(cmd, args)ActionExecute any arbitrary hyprctl dispatch instruction
Audio Routingget_audio_status()Read-OnlyQuery default sink, volume percentage, and mute state
Audio Routingtoggle_audio_sink()ActionCycle between Motherboard Line Out and TV HDMI
Audio Routingset_volume(pct)IdempotentAdjust active PipeWire hardware sink volume
Media & Filmaudit_media(path)Read-OnlyRun multi-point QC inspection on video or audio files
Media & Filmgenerate_video(prompt, opts)ActionTrigger iram-video documentary or cinema generator
Creative Suitelaunch_craft(app)IdempotentLaunch PhotoCraft, VectorCraft, FilmCraft, etc.
Desktop Themingset_theme(palette)IdempotentSwitch ALPORA desktop palette sub-100ms without restart
Diagnosticsget_system_health()Read-OnlyAudit failed system/user systemd units and RAM
Diagnosticsheal_system()ActionReset-failed units and recover audio/compositor daemons
Contextcondense_context(raw, query)DeterministicBM25 relevance ranking token compression up to 98%
Memorymemory_retain(fact, cat, imp)ActionRetain long-term episodic fact with recency decay
Memorymemory_recall(query)Read-OnlyRetrieve semantically ranked facts from agent store
Sovereign Creative Software

Storytold Craft Suite (11 Native Apps)

The Storytold Craft Suite is a high-performance, open-source creative suite built in Rust and GPU-accelerated graphics. It completely replaces proprietary subscription suites (Adobe Creative Cloud, Microsoft 365, Figma) with local, privacy-first sovereign tools.

PhotoCraft

Photoshop Alternative (Raster Image Editor)
craft-photocraft

High-speed raster graphics editor supporting PSD import, multi-layer compositing, non-destructive adjustment layers, neural inpainting, and GPU-accelerated brush engines.

Native File Formats
PSD, PSB, TIFF, PNG, EXR, WebP, JPEG-XL
CLI Trigger & Hotkey
iram craft photo ยท Super + Ctrl + Alt + C

Complete Creative Replacement Matrix

Storytold AppReplaces ProprietaryCore Engineering FocusLaunch Shortcut
PhotoCraftAdobe PhotoshopPSD layers, clone stamp, frequency separation, RAW exportiram craft photo
VectorCraftAdobe IllustratorBezier curves, typography on path, SVG/AI/EPS exportiram craft vector
FilmCraftAdobe Premiere ProMagnetic timeline, 4K multi-camera, color grading LUTsiram craft film
SoundCraftAvid Pro Tools / LogicPipeWire low-latency multi-track DAW, VST3, MIDI editingiram craft sound
FigCraftFigmaComponent tokens, auto-layout canvas, interactive prototypesiram craft fig
LightCraftAdobe LightroomNon-destructive RAW demosaicing, exposure curvesiram craft light
CADCraftAutoCAD / Fusion 3602D drafting, 3D parametric STEP/STL meshes, constraintsiram craft cad
WordCraftMicrosoft WordDistraction-free typographic word processor, DOCX importiram craft word
GridCraftMicrosoft ExcelHigh-throughput spreadsheets, pivot models, formula engineiram craft grid
DeckCraftMicrosoft PowerPointPresentation slide decks with animated CSS/WebGL transitionsiram craft deck
PdfCraftAdobe Acrobat ProPDF markup, cryptographic signatures, text redactioniram craft pdf
Creative Hub & Shortcuts

ArtCraft Launcher & Shortcut Architecture

The ArtCraft Launcher (artcraft-launcher or iram craft) provides an instant GUI and terminal dispatcher for the Storytold creative suite with system tray integration and hotkey management.

BASH ArtCraft Commands
# Open the ArtCraft GUI Launcher Hub
artcraft-launcher

# Or launch any creative application directly from terminal
iram craft photo    # Photoshop alternative
iram craft vector   # Illustrator alternative
iram craft film     # Premiere Pro alternative
iram craft sound    # Pro Tools alternative
iram craft cad      # AutoCAD alternative
iram craft fig      # Figma alternative

Dedicated Creative Shortcuts

ShortcutApplicationMode
Super + Ctrl + Alt + CPhotoCraftRaster editing & PSD canvas
Super + Ctrl + Alt + VVectorCraftVector design & typography
Super + Ctrl + Alt + FFilmCraftVideo timeline & color grading
Super + Ctrl + Alt + SSoundCraftPipeWire audio recording DAW
Super + Ctrl + Alt + DCADCraft2D drafting & 3D parametric CAD
Super + Ctrl + Alt + GFigCraftUI/UX design canvas & tokens
Cinema & Motion Graphics

Universal Film & Video Studio (`iram-video`)

iram-video is IRAM OS's sovereign film directing and compilation studio. It generates real documentary YouTube videos, animated featurettes, cinematic trailers, and Remotion motion graphics with automatic PipeWire audio routing.

BASH Real 1080p/4K YouTube Documentary Generator
# Real documentary with 1080p/4K stock B-roll, acoustic score, and zero cyberpunk hallucinations
iram video "The James Webb Space Telescope and Cosmic Dawn" --real

# Dual-language Tamil & English documentary with acoustic score
iram video "The History of Chola Maritime Power" --real --lang ta

# Mood-led cinema trailer with dramatic tension curve
iram video "The Silicon Sovereigns" --cinema --tension

# High-velocity vertical video for YouTube Shorts & Reels
iram video "Three Rules of Senior Software Architecture" --shorts
Agentic Film Direction

OpenMontage 12-Pipeline Hub

Integrated directly into iram video, OpenMontage provides 12 specialized agentic production pipelines capable of autonomous idea synthesis, scene planning, archive asset retrieval, and composition:

Pipeline IDCategoryDescriptionCommand Snippet
documentary-montagedocumentaryRetrieval-first thematic montage from NASA, Archive.org, Pexelsiram video montage "Prompt" --pipeline documentary-montage
animated-explainergeneratedRemotion React motion graphics explainer with KPIs and cardsiram video montage "Prompt" --pipeline animated-explainer
character-animationanimationCharacter animation pipeline for local SVG/diffusers assetsiram video montage "Prompt" --pipeline character-animation
cinematiccinematicMood-led trailer with dramatic tension curve & scoreiram video montage "Prompt" --pipeline cinematic
talking-headtalking_headPresenter-led talking-head video pipelineiram video montage "Prompt" --pipeline talking-head
avatar-spokespersoncustomDigital twin avatar spokesperson with audio synciram video montage "Prompt" --pipeline avatar-spokesperson
localization-dubcustomTranscript-first multi-language dubbing and subtitle synciram video montage "Prompt" --pipeline localization-dub
clip-factorycustomMulti-clip vertical extraction for Shorts, Reels, and TikTokiram video montage "Prompt" --pipeline clip-factory
podcast-repurposecustomLong-form audio to highlight video with dynamic waveformsiram video montage "Prompt" --pipeline podcast-repurpose
screen-demoscreen_recDeveloper screen recording pipeline with kinetic calloutsiram video montage "Prompt" --pipeline screen-demo
hybridhybridCombined AI video + real B-roll + Remotion graphicsiram video montage "Prompt" --pipeline hybrid
framework-smokecustomMinimal pipeline verification and smoke-test harnessiram video montage "Smoke" --pipeline framework-smoke
React Compositions & Storyboard

Remotion Motion Graphics & Backlot HUD

Render production-ready React compositions headlessly using the integrated Remotion Chrome Headless Shell and monitor productions via the Backlot living storyboard HUD:

BASH Remotion Direct Rendering & Backlot
# List available zero-key Remotion React templates
iram video demo list

# Render the Developer Workflow Explainer to 1080p MP4
iram video demo code-to-screen

# Launch Backlot living storyboard visual inspector
iram video backlot   # Opens at http://localhost:8080

# Run multi-point automated QC audit on any MP4 video
iram video --montage-audit out/video.mp4

Automated Multi-Point QC Media Audit

Verify stream integrity, duration consistency, loudness, and codecs across renders:

JSON Example Audit Report (`iram video --montage-audit`)
{
  "status": "ok",
  "media": {
    "file": "out/code-to-screen.mp4",
    "duration_seconds": 25.045,
    "format_name": "mov,mp4,m4a",
    "size_bytes": 3726241,
    "bit_rate": 1190238,
    "stream_count": 2,
    "audio": {
      "codec": "aac",
      "sample_rate": 48000,
      "channels": 2,
      "bit_rate": 317374
    }
  }
}
Visual Architecture

ALPORA Dynamic Theming & Circadian Timeline

IRAM OS features the ALPORA Theme Engine, providing 49 curated color palettes that switch sub-100ms across GTK3/4, Qt5/6, Hyprland borders, Waybar, Mako notifications, terminal emulators, and browsers without restarting running processes.

BASH ALPORA Theme Commands
# List all 49 curated desktop palettes
iram theme list

# Switch to a specific theme instantly
iram theme set tokyo-storm
iram theme set alpora-alpine
iram theme set rose-pine

# Start the 24-hour Circadian Sun/Sky timeline engine
iram theme timeline

# Render the faceted polygon mountain system card
iram fetch alpora

24-Hour Circadian Timeline Cycle

Time WindowPalette PhaseLighting DynamicsWaybar Gradient
06:00 โ€“ 09:00Alpora DawnSoft cool amber tint with rising daylight saturationDeep blue to morning gold
09:00 โ€“ 16:00Alpora AlpineHigh contrast crisp cobalt and ice-blue for maximum focusVibrant azure to cyan
16:00 โ€“ 19:00Rose SunsetWarm magenta and twilight rose to reduce blue lightRose gold to dusk indigo
19:00 โ€“ 00:00Tokyo Storm / Moon LakeDeep OLED midnight blue with neon cyan accentsDark violet to midnight
00:00 โ€“ 06:00Gruvbox Warm DesertUltra low-emission amber monochrome to prevent eye fatigueWarm charcoal to umber
Studio Audio & Neural Speech

VoiceStudio & System-Wide Voxtype

IRAM OS provides sovereign on-device neural voice cloning, design, and speech recognition integrated directly with the PipeWire low-latency audio server.

BASH VoiceStudio Operations
# Voice clone from a reference audio file
iram voice clone --reference samples/director.wav --name "Director"

# Neural speech synthesis directly to PipeWire studio monitors
iram voice speak "All autonomous systems are operational on IRAM OS."

# System-wide whisper dictation (Hold shortcut to dictate anywhere)
voxtype   # Shortcut: Super + Ctrl + V or dedicated microphone key

# Calibrate PipeWire DSP hardware tuning
iram audio tuning --latency 64
Autonomous Intelligence

AI Sidecar & Agent Swarm Factory

IRAM OS includes a native WebKitGTK floating Wayland AI Sidecar window and multi-agent topology execution runners.

BASH Agent Operations
# Toggle the native floating Wayland AI Sidecar window
iram sidecar   # Shortcut: Super + Ctrl + Alt + S

# Launch multi-account token failover daemon
iram agent daemon --rotate-tokens

# Dispatch autonomous multi-agent swarm team
iram openrig team --manifest factory.yaml
Window Management

Hyprland 0.56 & hypr-doctor Linter

hypr-doctor is a zero-dependency static analysis linter and duplicate keybinding detector that guarantees clean, error-free Hyprland configurations.

BASH Hypr Doctor
pip install hypr-doctor
hypr-doctor check ~/.config/hypr/hyprland.conf
hypr-doctor reload

Conflict-Free Dedicated AI Shortcut Layer

All autonomous ecosystem tools operate under the dedicated $mainMod CTRL ALT modifier namespace to eliminate window management collisions:

Key ShortcutTarget SubsystemExecution Command
Super + SpaceApp Launcherwofi --show drun
Super + ReturnTerminalfoot / alacritty
Super + QClose Windowhyprctl dispatch killactive
Super + Ctrl + PrintInstant Screen OCRiram-ocr
Super + Ctrl + Alt + SAI Sidecar HUDiram-sidecar
Super + Ctrl + Alt + OOpenRig Swarm Teamiram-openrig team
Super + Ctrl + Alt + VVideo Studioiram video
Super + Ctrl + Alt + CComfyUI Diffusion Canvasiram-comfyui (:8188)
Super + Ctrl + Alt + FFinancial Valuation (DCF)iram-finance dcf NVDA
Token Economy

context-condenser (98% BM25 Engine)

Eliminate LLM context exhaustion. context-condenser uses local SQLite FTS5 BM25 token frequency ranking to shrink logs, git diffs, and tool outputs prior to prompting.

BASH BM25 Context Compression
pip install context-condenser
cat debug.log | context-condenser -q "ConnectionResetError" --ratio 0.05
Episodic Intelligence

agent-hindsight (Temporal Memory)

Persistent long-term memory engine for AI coding agents with half-life recency decay and semantic reflection.

BASH Memory Retention & Recall
pip install agent-hindsight
agent-hindsight retain "Default sink is combined_displays at metric 100" -c audio -i 5
agent-hindsight recall "audio sink"
Supply Chain Defense

adversarial-pre-push Gate

6-phase security auditing git pre-push gate with separated Hunter and Verifier stages to catch secrets, eval leaks, and shell injection seams.

BASH Security Hook Installation
pip install adversarial-pre-push
adversarial-pre-push install-hook /path/to/repo
adversarial-pre-push audit .
Kernel Networking

linux-dual-wifi (ECMP Multi-WAN)

Aggregates concurrent internal PCIe and external USB Wi-Fi adapters using Linux kernel Equal-Cost Multi-Path policy routing tables and layer 4 flow hashing.

BASH Multi-WAN Balance
git clone https://github.com/apravint/linux-dual-wifi.git
cd linux-dual-wifi && ./install.sh
dual-wifi balance
WebGL Visual Computing

Three.js 3D Desktop Universe & WebGL Studio

IRAM OS provides spatial 3D WebGL desktop command hubs, kinetic title studios, and interactive particle simulators:

BASH 3D Studio Commands
# Launch 3D Desktop Command Universe
iram-3d

# Launch 3D kinetic typography studio
iram video --threejs

# Export standalone 3D motion scene to HTML
iram video --export-3d titles.html
Codebase Cartography

archify-py (Architecture Visualizer)

Zero-dependency architecture mapper that scans repositories and generates interactive glassmorphic HTML dashboards or embeddable SVG diagrams.

BASH Archify Execution
pip install archify-py
archify . --svg architecture.svg --open
Quantitative Analytics

IRAM Quant Cross-Market Trading System

Cross-market algorithmic stock leader scanner covering US (NYSE/NASDAQ) and Indian (NSE) equities simultaneously with automated morning briefings and DCF valuation.

BASH Quant Market Screening
# Algorithmic screening across US market leaders
iram quant us

# Algorithmic screening across NSE India market leaders
iram quant in

# Calculate DCF intrinsic value
iram-finance dcf NVDA
Distribution Mastering

Ubuntu 26.10 Live ISO Toolchain

Automated toolchain with headless QEMU boot verification to compile bootable hybrid Live ISOs.

BASH ISO Compilation
git clone https://github.com/apravint/ubuntu-hyprland-iso-builder.git
cd ubuntu-hyprland-iso-builder
sudo bash build/build-iso.sh