MaruxOS is the world's first operating system built 100% with AI (Claude Code).

Unlike Ubuntu, Fedora, or Arch which are based on existing Linux distributions, MaruxOS is built entirely from the Linux kernel using Linux From Scratch (LFS). Every single component - from the bootloader to the desktop environment - was compiled from source code with AI assistance.

• 100% AI-Built OS - Every script, configuration, and build process created with Claude Code
• Not Distribution-Based - Built directly from Linux kernel, not forked from Ubuntu/Debian/Arch
• Pure LFS - Following Linux From Scratch methodology from scratch

• Pure LFS Base - Not based on Debian, Ubuntu, or any other distribution
• Lightweight - Minimal footprint with only essential components
• Custom Desktop - Openbox + Plank dock + picom compositor + self-made marux-quicksettings status bar, Qt5 app set (QTerminal, PCManFM-Qt, FeatherPad, LXImage-Qt, SpeedCrunch, LXQt Archiver, qps)
• Live Boot - Boot directly from USB/CD without installation
• Modern Kernel - Linux 6.18.26 LTS
• Korean Input - Full Korean (Hangul) input support via ibus-hangul (Shift+Space toggle; GTK, Qt and XIM apps), 한/A indicator in the status bar

1. Download the latest ISO from releases
2. Create bootable USB using Rufus (Windows) or dd (Linux)
3. Boot from USB
4. Login is automatic (root user)
5. Desktop starts automatically via startx

MaruxOS/
├── config/                 # Configuration files
│   ├── plank/             # Dock launchers (tint2/ = retired 1.x panel config)
│   ├── openbox/           # Window manager settings
│   └── applications/      # Desktop entries
├── kernel/                 # Linux kernel
│   └── source/            # Kernel source (6.18.26 LTS)
├── scripts/               # Build scripts
├── output/                # Built ISO files
├── MaruxOS 디자인/        # Branding assets
│   ├── wallpapers/        # Desktop wallpapers
│   └── icons/             # Custom icons
├── ISO-BUILD-HISTORY.md   # Build changelog (Korean)
├── ISO-BUILD-HISTORY-EN.md # Build changelog (English)
└── README.md              # This file

MaruxOS is built using WSL (Windows Subsystem for Linux) with the following structure:

/home/administrator/MaruxOS/build/
├── rootfs-lfs/            # Root filesystem
├── iso-build/             # ISO staging
│   ├── boot/              # Kernel & initrd
│   │   ├── vmlinuz        # Linux kernel
│   │   ├── initrd.img     # Initial ramdisk
│   │   └── grub/          # GRUB bootloader
│   └── live/
│       └── filesystem.squashfs  # Compressed root filesystem

Current entry points (see scripts/README.md for the full index; superseded versions live in scripts/archive/):

# x86_64 Live ISO (cooked-v10): parity rootfs → slim staging → gates → squashfs(xz) → ISO
sudo WSL_KERNEL_BUILD_ROOT=/home/$USER/MaruxOS-kernel-build bash scripts/build-2.0.0-cooked-v10.sh

# ARM64 / Raspberry Pi 4B image (arm64-v34) — run from ~/MaruxOS-arm64
sudo bash scripts/build-2.0.0-cooked-arm64-v34.sh

# Boot test (x86_64)
qemu-system-x86_64 -m 4G -enable-kvm -device intel-hda -device hda-duplex -cdrom output/MaruxOS-2.0.0-x86_64.iso

• Live boot only - No disk installation support yet
• No package manager - Software is pre-installed
• x86_64 ISO desktop parity landed 2026-08-28 (cooked-v10) - same Qt5 app set as the Pi image; audio backend in the Live ISO depends on the host card (no PulseAudio, ALSA only)

• Disk installation support
• Package management system
• GUI file manager — PCManFM-Qt (Qt5 stack landed with QTerminal) on ARM64 (v27) and x86_64 (cooked-v10, 2026-08-28)
• Korean input support (v1.1)
• More language support (Japanese, Chinese)
• ARM64 / Raspberry Pi 4B support (2.0.0 — verified on real hardware: full desktop with Plank dock + picom compositor, Korean input in GTK3/Qt5 apps and Firefox, wired networking with NTP)
• ARM64 WiFi + self-made quick-settings panel GUI (verified on real hardware) → QTerminal (Qt5) → PCManFM-Qt — 2.0.0 roadmap complete; final hardware verification pending

• Discord: pizzamaru_
• Email: marudev@outlook.kr
• Portfolio: https://marulee.dev
• Issues: GitHub Issues

MaruxOS's own work (build system, configuration, documentation, marux-quicksettings, MaruxOS-drawn icons) is dedicated to the public domain under The Unlicense (public domain dedication, OSI-approved) — use it for anything, no attribution required.

A MaruxOS image is an aggregate: every third-party component keeps its own license — Linux kernel (GPL-2.0), glibc / Qt 5 (LGPL), Firefox (MPL-2.0, unmodified official build), Openbox, Plank, X.org, ibus-hangul, Raspberry Pi / Cypress firmware (proprietary, redistributable), Nanum fonts (OFL 1.1), and more. See:

• LICENSING.md — Unlicense text, scope, and the written offer for corresponding source
• THIRD-PARTY-LICENSES.md — component-by-component list and how we comply
• SOURCES.md — exact upstream tarballs (version, URL, SHA256)
• patches/ — every modification we make to upstream code

Sigterm Co., Ltd. (시그텀 주식회사) - For sponsoring the Claude Code MAX plan that made this project possible.

MaruxOS는 세계 최초로 100% AI(Claude Code)만으로 제작된 운영체제입니다.

우분투, 페도라, 아치처럼 기존 리눅스 배포판을 기반으로 하지 않고, Linux From Scratch (LFS)를 사용하여 리눅스 커널부터 완전히 새로 빌드했습니다. 부트로더부터 데스크톱 환경까지 모든 구성 요소가 AI의 도움으로 소스 코드에서 컴파일되었습니다.

• 100% AI 제작 OS - 모든 스크립트, 설정, 빌드 과정이 Claude Code로 제작
• 배포판 기반 아님 - 우분투/데비안/아치에서 포크하지 않고 리눅스 커널부터 직접 빌드
• 순수 LFS - Linux From Scratch 방법론을 처음부터 따름

• 순수 LFS 기반 - 데비안, 우분투 등 다른 배포판 기반 아님
• 경량 - 필수 구성 요소만 포함한 최소한의 시스템
• 커스텀 데스크톱 - Openbox + Plank 독 + picom 컴포지터 + 자체 제작 marux-quicksettings 상태 바, Qt5 앱 세트(QTerminal, PCManFM-Qt, FeatherPad, LXImage-Qt, SpeedCrunch, LXQt Archiver, qps)
• 라이브 부팅 - USB/CD에서 설치 없이 바로 부팅
• 최신 커널 - Linux 6.18.26 LTS
• 한글 입력 지원 - ibus-hangul 기반 한/영 전환 (Shift+Space; GTK·Qt·XIM 앱), 상태 바 한/A 표시

1. releases에서 최신 ISO 다운로드
2. Rufus (Windows) 또는 dd (Linux)로 부팅 USB 생성
3. USB로 부팅
4. 자동 로그인 (root 사용자)
5. startx로 데스크톱 자동 시작

• 라이브 부팅만 가능 - 디스크 설치 미지원
• 패키지 관리자 없음 - 소프트웨어 사전 설치됨
• x86_64 ISO 데스크톱 패리티 완료 (2026-08-28, cooked-v10) - Pi 이미지와 동일한 Qt5 앱 구성. Live ISO의 오디오는 호스트 카드 의존(PulseAudio 없음, ALSA만)

• Discord: pizzamaru_
• Email: marudev@outlook.kr
• Portfolio: https://marulee.dev
• 이슈: GitHub Issues

Sigterm Co., Ltd. (시그텀 주식회사) - 이 프로젝트를 가능하게 해준 Claude Code MAX 플랜 지원에 감사드립니다.