A fast, clean, Arch-based operating system with an offline AI that understands your system.
No cloud. No spying. No magic. Just control.
AiOS is a fully customized Arch Linux–based operating system built for real daily use, not as a demo or short-term project.
The core idea is simple:
Your operating system should understand itself — and help you understand it.
AiOS combines:
- a clean, modern Wayland desktop
- strong system safety and recovery
- a fully offline, system-aware AI assistant
No internet dependency.
No cloud APIs.
No silent automation.
AiOS is built on non-negotiable principles:
- 🔒 Offline-first — works without internet
- 🧠 AI is assistive, not autonomous
- 🧾 Everything is explainable
- ♻️ Recovery is always possible
- 🎯 Stability over novelty
- 🧑💻 Power without unnecessary complexity
If a feature violates these principles, it does not belong in AiOS.
AiOS includes a local, offline AI assistant that:
- understands your actual filesystem
- knows where configs, logs, and binaries live
- searches files in milliseconds using a local index
- explains errors, services, and system behavior
- suggests safe actions — never executes without permission
- ❌ no cloud calls
- ❌ no telemetry
- ❌ no background automation
- ❌ no root access without approval
The AI reads. Plans. Explains.
You decide.
- Arch Linux base
- Custom Live ISO & installer
- BTRFS with snapshots by default
- Safe rollback & recovery
- Offline LLM (7B+)
- System-aware file index
- Nano-second search
- Structured instruction planning (no raw shell execution)
- Wayland + Hyprland
- Clean, minimal rice
- Custom boot splash & GRUB theme
- Modular theming system
- Central settings UI
- Performance & power profiles
- Reversible system mods
- Transparent logs
🚧 ALPHA — UNDER ACTIVE DEVELOPMENT
Current progress:
- ✅ Vision & core specification
- ✅ Development roadmap
- ✅ Arch ISO skeleton (Phase 1)
- 🚧 Installer & live environment
- ⏳ Core services (indexing, settings)
- ⏳ Desktop & AI integration
This is not yet ready for daily use, but it is being built with daily use as the goal.
Phase 0 ── Vision & Principles ✅
Phase 1 ── Installer & ISO 🚧
Phase 2 ── Core System Services ⏳
Phase 3 ── Desktop Environment ⏳
Phase 4 ── Offline AI (read-only) ⏳
Phase 5 ── AI Actions (controlled) ⏳
Phase 6 ── Polish, Docs & Stability ⏳
Detailed roadmap: docs/devphases.md
- Base: Arch Linux
- Installer: archiso + custom scripts
- Filesystem: BTRFS
- Desktop: Wayland (Hyprland)
- AI Runtime: local LLM (offline)
- Indexing: inotify + fast local database
- Init system: systemd
- UI: GTK / Tauri (planned)
AiOS/
- iso/ — Live ISO & installer
- installer/ — Install scripts
- services/ — Core daemons (index, AI, settings)
- ui/ — Settings & assistant UI
- themes/ — Desktop & boot themes
- docs/ — Specs & documentation
- README.md
AiOS is designed for:
- Linux power users
- Developers
- Students
- Privacy-focused users
- Arch users who want a clean, intelligent system
If you want:
- cloud AI
- auto-magic
- locked-down systems
- hidden automation
AiOS is probably not for you — and that’s intentional.
AiOS is currently in an early, single-maintainer phase.
Contribution guidelines, issues, and design discussions will open once the core system stabilizes.
For now, the focus is building it right.
AiOS is open-source.
License details will be finalized as the project matures.
AiOS is not trying to replace every Linux distribution.
It’s trying to do one thing well:
Give users a fast, beautiful, trustworthy OS that understands itself — offline.
If that resonates with you, stay tuned.
This is just the beginning.
⭐ Star the repo if this project interests you
🧠 Discussions and RFCs coming soon

