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.
๐ป Interactive CLI Terminal Simulator
Click any command chip below to preview real formatted terminal outputs from the unified iram CLI dispatcher:
Core Subsystem Hierarchy
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).
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:
Catalog of 28 Native OS Tools
| Category | Tool Name | Tier / Behavior | Function Payload |
|---|---|---|---|
| Window Mgmt | get_windows() | Read-Only | Enumerate all active clients, geometry, and workspaces |
| Window Mgmt | focus_window(target) | Idempotent | Focus client by title substring, class, or hex address |
| Window Mgmt | dispatch_hyprland(cmd, args) | Action | Execute any arbitrary hyprctl dispatch instruction |
| Audio Routing | get_audio_status() | Read-Only | Query default sink, volume percentage, and mute state |
| Audio Routing | toggle_audio_sink() | Action | Cycle between Motherboard Line Out and TV HDMI |
| Audio Routing | set_volume(pct) | Idempotent | Adjust active PipeWire hardware sink volume |
| Media & Film | audit_media(path) | Read-Only | Run multi-point QC inspection on video or audio files |
| Media & Film | generate_video(prompt, opts) | Action | Trigger iram-video documentary or cinema generator |
| Creative Suite | launch_craft(app) | Idempotent | Launch PhotoCraft, VectorCraft, FilmCraft, etc. |
| Desktop Theming | set_theme(palette) | Idempotent | Switch ALPORA desktop palette sub-100ms without restart |
| Diagnostics | get_system_health() | Read-Only | Audit failed system/user systemd units and RAM |
| Diagnostics | heal_system() | Action | Reset-failed units and recover audio/compositor daemons |
| Context | condense_context(raw, query) | Deterministic | BM25 relevance ranking token compression up to 98% |
| Memory | memory_retain(fact, cat, imp) | Action | Retain long-term episodic fact with recency decay |
| Memory | memory_recall(query) | Read-Only | Retrieve semantically ranked facts from agent store |
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
High-speed raster graphics editor supporting PSD import, multi-layer compositing, non-destructive adjustment layers, neural inpainting, and GPU-accelerated brush engines.
Complete Creative Replacement Matrix
| Storytold App | Replaces Proprietary | Core Engineering Focus | Launch Shortcut |
|---|---|---|---|
| PhotoCraft | Adobe Photoshop | PSD layers, clone stamp, frequency separation, RAW export | iram craft photo |
| VectorCraft | Adobe Illustrator | Bezier curves, typography on path, SVG/AI/EPS export | iram craft vector |
| FilmCraft | Adobe Premiere Pro | Magnetic timeline, 4K multi-camera, color grading LUTs | iram craft film |
| SoundCraft | Avid Pro Tools / Logic | PipeWire low-latency multi-track DAW, VST3, MIDI editing | iram craft sound |
| FigCraft | Figma | Component tokens, auto-layout canvas, interactive prototypes | iram craft fig |
| LightCraft | Adobe Lightroom | Non-destructive RAW demosaicing, exposure curves | iram craft light |
| CADCraft | AutoCAD / Fusion 360 | 2D drafting, 3D parametric STEP/STL meshes, constraints | iram craft cad |
| WordCraft | Microsoft Word | Distraction-free typographic word processor, DOCX import | iram craft word |
| GridCraft | Microsoft Excel | High-throughput spreadsheets, pivot models, formula engine | iram craft grid |
| DeckCraft | Microsoft PowerPoint | Presentation slide decks with animated CSS/WebGL transitions | iram craft deck |
| PdfCraft | Adobe Acrobat Pro | PDF markup, cryptographic signatures, text redaction | iram craft pdf |
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.
# 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
| Shortcut | Application | Mode |
|---|---|---|
Super + Ctrl + Alt + C | PhotoCraft | Raster editing & PSD canvas |
Super + Ctrl + Alt + V | VectorCraft | Vector design & typography |
Super + Ctrl + Alt + F | FilmCraft | Video timeline & color grading |
Super + Ctrl + Alt + S | SoundCraft | PipeWire audio recording DAW |
Super + Ctrl + Alt + D | CADCraft | 2D drafting & 3D parametric CAD |
Super + Ctrl + Alt + G | FigCraft | UI/UX design canvas & tokens |
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.
# 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
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 ID | Category | Description | Command Snippet |
|---|---|---|---|
documentary-montage | documentary | Retrieval-first thematic montage from NASA, Archive.org, Pexels | iram video montage "Prompt" --pipeline documentary-montage |
animated-explainer | generated | Remotion React motion graphics explainer with KPIs and cards | iram video montage "Prompt" --pipeline animated-explainer |
character-animation | animation | Character animation pipeline for local SVG/diffusers assets | iram video montage "Prompt" --pipeline character-animation |
cinematic | cinematic | Mood-led trailer with dramatic tension curve & score | iram video montage "Prompt" --pipeline cinematic |
talking-head | talking_head | Presenter-led talking-head video pipeline | iram video montage "Prompt" --pipeline talking-head |
avatar-spokesperson | custom | Digital twin avatar spokesperson with audio sync | iram video montage "Prompt" --pipeline avatar-spokesperson |
localization-dub | custom | Transcript-first multi-language dubbing and subtitle sync | iram video montage "Prompt" --pipeline localization-dub |
clip-factory | custom | Multi-clip vertical extraction for Shorts, Reels, and TikTok | iram video montage "Prompt" --pipeline clip-factory |
podcast-repurpose | custom | Long-form audio to highlight video with dynamic waveforms | iram video montage "Prompt" --pipeline podcast-repurpose |
screen-demo | screen_rec | Developer screen recording pipeline with kinetic callouts | iram video montage "Prompt" --pipeline screen-demo |
hybrid | hybrid | Combined AI video + real B-roll + Remotion graphics | iram video montage "Prompt" --pipeline hybrid |
framework-smoke | custom | Minimal pipeline verification and smoke-test harness | iram video montage "Smoke" --pipeline framework-smoke |
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:
# 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:
{
"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
}
}
}
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.
# 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 Window | Palette Phase | Lighting Dynamics | Waybar Gradient |
|---|---|---|---|
| 06:00 โ 09:00 | Alpora Dawn | Soft cool amber tint with rising daylight saturation | Deep blue to morning gold |
| 09:00 โ 16:00 | Alpora Alpine | High contrast crisp cobalt and ice-blue for maximum focus | Vibrant azure to cyan |
| 16:00 โ 19:00 | Rose Sunset | Warm magenta and twilight rose to reduce blue light | Rose gold to dusk indigo |
| 19:00 โ 00:00 | Tokyo Storm / Moon Lake | Deep OLED midnight blue with neon cyan accents | Dark violet to midnight |
| 00:00 โ 06:00 | Gruvbox Warm Desert | Ultra low-emission amber monochrome to prevent eye fatigue | Warm charcoal to umber |
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.
# 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
AI Sidecar & Agent Swarm Factory
IRAM OS includes a native WebKitGTK floating Wayland AI Sidecar window and multi-agent topology execution runners.
# 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
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.
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 Shortcut | Target Subsystem | Execution Command |
|---|---|---|
Super + Space | App Launcher | wofi --show drun |
Super + Return | Terminal | foot / alacritty |
Super + Q | Close Window | hyprctl dispatch killactive |
Super + Ctrl + Print | Instant Screen OCR | iram-ocr |
Super + Ctrl + Alt + S | AI Sidecar HUD | iram-sidecar |
Super + Ctrl + Alt + O | OpenRig Swarm Team | iram-openrig team |
Super + Ctrl + Alt + V | Video Studio | iram video |
Super + Ctrl + Alt + C | ComfyUI Diffusion Canvas | iram-comfyui (:8188) |
Super + Ctrl + Alt + F | Financial Valuation (DCF) | iram-finance dcf NVDA |
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.
pip install context-condenser
cat debug.log | context-condenser -q "ConnectionResetError" --ratio 0.05
agent-hindsight (Temporal Memory)
Persistent long-term memory engine for AI coding agents with half-life recency decay and semantic reflection.
pip install agent-hindsight
agent-hindsight retain "Default sink is combined_displays at metric 100" -c audio -i 5
agent-hindsight recall "audio sink"
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.
pip install adversarial-pre-push
adversarial-pre-push install-hook /path/to/repo
adversarial-pre-push audit .
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.
git clone https://github.com/apravint/linux-dual-wifi.git
cd linux-dual-wifi && ./install.sh
dual-wifi balance
Three.js 3D Desktop Universe & WebGL Studio
IRAM OS provides spatial 3D WebGL desktop command hubs, kinetic title studios, and interactive particle simulators:
# 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
archify-py (Architecture Visualizer)
Zero-dependency architecture mapper that scans repositories and generates interactive glassmorphic HTML dashboards or embeddable SVG diagrams.
pip install archify-py
archify . --svg architecture.svg --open
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.
# 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
Ubuntu 26.10 Live ISO Toolchain
Automated toolchain with headless QEMU boot verification to compile bootable hybrid Live ISOs.
git clone https://github.com/apravint/ubuntu-hyprland-iso-builder.git
cd ubuntu-hyprland-iso-builder
sudo bash build/build-iso.sh