Skip to content

AnuranjanJain/AiOS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧠 AiOS — An Offline, System-Aware Linux OS

AiOS Banner

A fast, clean, Arch-based operating system with an offline AI that understands your system.
No cloud. No spying. No magic. Just control.

Status Base AI License


✨ What is AiOS?

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.


🧩 Core Philosophy

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.


🤖 The AI (What Makes AiOS Different)

AiOS AI Demo

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

What it does NOT do

  • ❌ no cloud calls
  • ❌ no telemetry
  • ❌ no background automation
  • ❌ no root access without approval

The AI reads. Plans. Explains.
You decide.


⚡ Key Features

🧱 System Foundation

  • Arch Linux base
  • Custom Live ISO & installer
  • BTRFS with snapshots by default
  • Safe rollback & recovery

🧠 System Intelligence

  • Offline LLM (7B+)
  • System-aware file index
  • Nano-second search
  • Structured instruction planning (no raw shell execution)

🎨 Desktop Experience

  • Wayland + Hyprland
  • Clean, minimal rice
  • Custom boot splash & GRUB theme
  • Modular theming system

⚙️ System Control

  • Central settings UI
  • Performance & power profiles
  • Reversible system mods
  • Transparent logs

🧭 Project Status

🚧 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.


🗺️ Roadmap Overview

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


🛠️ Tech Stack

  • 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)

📁 Repository Structure

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

👥 Who is this for?

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.


🤝 Contributing

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.


📜 License

AiOS is open-source.
License details will be finalized as the project matures.


✨ Final Note

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

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages