Welcome to the official build system for LuminOS.

LuminOS is a privacy-focused AI operating system built on Debian 13 (Trixie) designed for users who want powerful AI tools running locally without cloud dependency.

The system integrates Lumin, a fully offline AI assistant powered by Ollama + local LLM models, while maintaining the transparency and stability of Debian.

The goal of LuminOS is simple:

Build the first truly transparent AI operating system where AI runs locally, securely, and privately.

No tracking.
No cloud dependency.
Just pure local intelligence.

User: liveuser Password: luminos 

⚠️ Keyboard Notice

The live ISO uses US (QWERTY) layout by default.

If you use AZERTY, type the password like this:

l u , i n o s 

(the m key is on the , position)

LuminOS ships with carefully selected software.

• KDE Plasma (Dark Theme)
• Modern UI
• Lightweight configuration

• Lumin AI Assistant
• Ollama Runtime
• Local LLM models
• Fully offline capable

• OnlyOffice Desktop Editors
• Word / Excel / PowerPoint compatible

• VLC Media Player
• Full codec support (h264, mp3, etc)

• Timeshift – system restore
• Flatpak – application store
• Firefox – web browser

LuminOS follows a transparent build pipeline.

Host System │ ▼ Bootstrap Debian Base │ ▼ Install Core Packages │ ▼ Inject AI Runtime (Ollama) │ ▼ Install Desktop Environment │ ▼ Apply Customization │ ▼ Compress Filesystem (SquashFS) │ ▼ Generate Bootable Hybrid ISO 

Host OS: Ubuntu 24.04 LTS or Debian 12+ RAM: 8GB minimum Disk Space: 30GB+ Privileges: sudo 

git clone https://github.com/4LuminOS/build-scripts.git cd build-scripts

sudo ./build.sh

After completion:

LuminOS-0.2.1-amd64.iso 

will appear in the project directory.

LuminOS integrates local AI inference.

User │ ▼ Lumin AI Assistant │ ▼ Ollama Runtime │ ▼ Local LLM Model │ ▼ Response 

Benefits:

• Fully offline AI
• No data leaves your machine
• No API cost
• Fast inference

• Improve automated build system
• Add graphical installer
• Better AI assistant integration
• Reduce ISO size
• Improve hardware compatibility
• GPU acceleration for AI
• Multi-model AI support

Contributions are welcome.

You can help by:

• Improving build scripts
• Fixing bugs
• Optimizing ISO generation
• Improving documentation
• Adding AI features

1 Fork the repository 2 Create a feature branch 3 Commit your changes 4 Open a Pull Request 

This project is licensed under:

GPL-3.0 License

LuminOS aims to become a next-generation AI operating system where users can run powerful AI tools locally, privately, and securely.

The long-term goal is to build a fully transparent AI ecosystem.

⭐ If you like the project, consider starring the repository.

It helps the project grow and reach more developers.

Built with ❤️ by the LuminOS Community