An AI-native Linux distribution with deep LLM integration

MAGI OS is an experimental Linux distribution that deeply integrates AI capabilities into the core desktop experience. Built on Debian and MATE/GTK technologies, it provides a complete operating system designed for exploring new paradigms of human-AI interaction in desktop computing.

• 🧠 Local LLM integration via Ollama
• 🎤 Voice interface with Whisper
• 🖥️ Custom GTK4-based shell
• 🔒 Privacy-focused (all AI runs locally)
• ⚡ NVIDIA GPU acceleration support

• CPU: x86_64 processor
• RAM: 16GB minimum (32GB recommended)
• GPU: NVIDIA GTX 1080 or better
• VRAM: 8GB minimum (24GB recommended)
• Storage: 30GB minimum

Visit 255.one to download the latest MAGI OS ISO.

MAGI OS can be built on any Debian-based system:

# Clone the repository
git clone https://github.com/ruapotato/MAGI
cd MAGI

# Install dependencies
sudo apt install xclip wmctrl xdotool x11-utils

# For local installation
./bin/setup.sh

# To build the ISO (requires root)
sudo ./bin/build.sh

The build process will:

1. Set up a clean build environment
2. Download required packages and drivers
3. Configure system components
4. Create a bootable ISO

The resulting ISO will be in the magi-os-build directory.

MAGI/
├── LICENSE
├── README.md
├── bin/          # Executable scripts
├── setup/        # Installation and build scripts
├── src/
│   ├── magi_shell/   # Core shell components
│   │   ├── core/     # Core functionality
│   │   ├── models/   # AI model integration
│   │   ├── monitors/ # System monitoring
│   │   ├── utils/    # Internal utilities
│   │   └── widgets/  # GUI components
│   └── utils/        # Standalone utilities and servers
├── docs/         # Documentation

• MAGI Shell: Custom GTK4-based desktop environment
• Ollama: Local LLM integration
• Whisper: Speech-to-text processing
• MATE: Base desktop components
• NVIDIA: GPU acceleration stack

• Context-aware command interpretation
• Voice control interface
• Local LLM processing
• Task automation capabilities
• Adaptive workspace management

Edit ~/.config/magi/config.json:

{
    "panel_height": 28,
    "workspace_count": 4,
    "enable_effects": true,
    "enable_ai": true,
    "terminal": "mate-terminal",
    "launcher": "mate-panel --run-dialog",
    "background": "/usr/share/magi/backgrounds/default.png",
    "ollama_model": "mistral",
    "whisper_endpoint": "http://localhost:5000/transcribe",
    "sample_rate": 16000
}

• Basic desktop environment
• Window management
• Session handling
• Local LLM integration
• Voice recognition
• Context system
• NVIDIA driver support
• ISO building
• Modular code organization
• Improved build scripts

• Installer
• AI-powered agents
• Workspace-specific app lists
• Background image settings
• Improved model management
• System update mechanism

See CONTRIBUTING.md for detailed contribution guidelines and setup instructions.

• All AI processing runs locally
• No data leaves your system
• Models can be audited and replaced
• Standard Linux security model
• Regular security updates via Debian base

Copyright (C) 2024 David Hamner

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

• Website: 255.one
• Email: [email protected]
• GitHub Issues: Project Issues

Current Stage: Public Alpha Test

• Basic functionality working
• Active development
• Community contributions welcome
• Not recommended for production use

MAGI OS is a research project exploring the future of AI-integrated computing environments. While functional, it should be considered experimental software.