Home

Jump to bottom

madkoding edited this page Mar 19, 2026 · 4 revisions

madOS Wiki

AI-Orchestrated Arch Linux System optimized for low-RAM systems (1.9GB) with integrated OpenCode AI assistance.

Getting Started

Installation - How to install madOS
Building the ISO - Build madOS from source
Persistence - Configure USB persistence for Live USB

Features

Desktop Environment - Sway, Hyprland, Waybar, Wofi
Applications - Chromium, VS Code, Photo/PDF/Video viewers
madOS Apps - Native Python applications
Audio System - PipeWire, Equalizer, High-quality audio
Developer Tools - OpenCode, Node.js, Git

Configuration

Customization - Customize your madOS
Hardware Support - Supported hardware
System Optimization - ZRAM, EarlyOOM, kernel tuning

Troubleshooting

Debugging - How to debug issues
Troubleshooting - Common problems and solutions

Development

Credits - Acknowledgments

For more information, visit the madOS GitHub Repository