The World's First OS Built 100% with AI
Not based on Ubuntu, Debian, or any distribution - Pure Linux From Scratch
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 window manager with tint2 panel
- Live Boot - Boot directly from USB/CD without installation
- Modern Kernel - Linux 6.12 LTS
- Korean Input - Full Korean (Hangul) input support via ibus-hangul (Ctrl+Y toggle)
| Component | Minimum | Recommended |
|---|---|---|
| CPU | x86_64 (64-bit) | Dual-core 2GHz+ |
| RAM | 1GB | 2GB+ |
| Storage | Live boot only | - |
| Graphics | VGA compatible | Any modern GPU |
| Category | Software |
|---|---|
| Window Manager | Openbox |
| Panel | tint2 |
| Terminal | xterm |
| File Manager | mc (Midnight Commander) |
| Web Browser | Firefox |
| Wallpaper | feh |
| Korean Input | ibus-hangul 1.5.5 (libhangul 0.2.0, ibus 1.5.29) |
| Korean Fonts | Nanum Gothic, Nanum Myeongjo |
- Download the latest ISO from releases
- Create bootable USB using Rufus (Windows) or
dd(Linux) - Boot from USB
- Login is automatic (root user)
- Desktop starts automatically via
startx
| Action | Key |
|---|---|
| Korean/English Toggle | Ctrl+Y or Shift+Space |
| Keyboard Layout | Dubeolsik (2-set QWERTY) |
| Hanja Conversion | F9 |
| Issue | Description |
|---|---|
| No Desktop Icons | Desktop file system not supported (unlike Windows) |
| Terminal Korean Display | Korean text may display incorrectly in xterm (Firefox and GTK3 apps work fine) |
| Legacy File Manager | mc (Midnight Commander) is text-based and outdated |
MaruxOS/
├── config/ # Configuration files
│ ├── tint2/ # Panel configuration
│ ├── openbox/ # Window manager settings
│ └── applications/ # Desktop entries
├── kernel/ # Linux kernel
│ └── source/ # Kernel source (6.12 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
# Create squashfs
mksquashfs rootfs-lfs iso-build/live/filesystem.squashfs -comp gzip -e boot -noappend
# Create ISO
grub-mkrescue -o MaruxOS-1.0.iso iso-build- Live boot only - No disk installation support yet
- No package manager - Software is pre-installed
- Terminal-based file manager - GUI file manager has library issues
- Terminal Korean display - xterm may not display Korean correctly (GTK3 apps work fine)
- Disk installation support
- Package management system
- GUI file manager
-
Korean input support(v1.1) - More language support (Japanese, Chinese)
- ARM architecture support
- Discord:
pizzamaru_ - Email: marudev@outlook.kr
- Portfolio: https://marulee.dev
- Issues: GitHub Issues
MaruxOS is released into the Public Domain - complete freedom with no restrictions.
Components have their respective licenses:
- Linux Kernel: GPL-2.0
- Openbox: GPL-2.0
- tint2: GPL-2.0
- Firefox: MPL-2.0
| Role | Credit |
|---|---|
| UI/UX Design | tuna27 |
| AI Development | Claude Code (Anthropic) |
| Base System | Linux From Scratch |
| Kernel | kernel.org |
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 윈도우 매니저 + tint2 패널
- 라이브 부팅 - USB/CD에서 설치 없이 바로 부팅
- 최신 커널 - Linux 6.12 LTS
- 한글 입력 지원 - ibus-hangul 기반 한/영 전환 (Ctrl+Y)
| 구성 요소 | 최소 | 권장 |
|---|---|---|
| CPU | x86_64 (64비트) | 듀얼코어 2GHz+ |
| RAM | 1GB | 2GB+ |
| 저장 장치 | 라이브 부팅만 가능 | - |
| 그래픽 | VGA 호환 | 최신 GPU |
| 분류 | 소프트웨어 |
|---|---|
| 윈도우 매니저 | Openbox |
| 패널 | tint2 |
| 터미널 | xterm |
| 파일 관리자 | mc (Midnight Commander) |
| 웹 브라우저 | Firefox |
| 배경화면 | feh |
| 한글 입력기 | ibus-hangul 1.5.5 (libhangul 0.2.0, ibus 1.5.29) |
| 한국어 폰트 | 나눔고딕, 나눔명조 |
- releases에서 최신 ISO 다운로드
- Rufus (Windows) 또는
dd(Linux)로 부팅 USB 생성 - USB로 부팅
- 자동 로그인 (root 사용자)
startx로 데스크톱 자동 시작
| 동작 | 키 |
|---|---|
| 한/영 전환 | Ctrl+Y 또는 Shift+Space |
| 자판 배열 | 2벌식 (QWERTY) |
| 한자 변환 | F9 |
- 라이브 부팅만 가능 - 디스크 설치 미지원
- 패키지 관리자 없음 - 소프트웨어 사전 설치됨
- 터미널 기반 파일 관리자 - GUI 파일 관리자 라이브러리 문제
- 터미널 한글 표시 - xterm에서 한글 표시가 깨질 수 있음 (Firefox 등 GTK3 앱은 정상)
- Discord:
pizzamaru_ - Email: marudev@outlook.kr
- Portfolio: https://marulee.dev
- 이슈: GitHub Issues
| 역할 | 크레딧 |
|---|---|
| UI/UX 디자인 | tuna27 |
| AI 개발 | Claude Code (Anthropic) |
| 베이스 시스템 | Linux From Scratch |
| 커널 | kernel.org |
Sigterm Co., Ltd. (시그텀 주식회사) - 이 프로젝트를 가능하게 해준 Claude Code MAX 플랜 지원에 감사드립니다.
Current Version: 1.1 "67"
Made with Linux From Scratch 12.1 Made with ❤️ for the Linux community