AI Computer OS

▄████▄ ██   ▄█████  ▄▄▄  ▄▄   ▄▄ ▄▄▄▄  ▄▄ ▄▄ ▄▄▄▄▄▄ ▄▄▄▄▄ ▄▄▄▄  
██▄▄██ ██   ██     ██▀██ ██▀▄▀██ ██▄█▀ ██ ██   ██   ██▄▄  ██▄█▄ 
██  ██ ██   ▀█████ ▀███▀ ██   ██ ██    ▀███▀   ██   ██▄▄▄ ██ ██ 

A modern, beautiful Linux distribution built on GNOME and Wayland, optimized for AI workflows and daily productivity.

Features

• GNOME Desktop - Clean, modern desktop environment with Wayland
• AI Ready - Voxtype voice input, Claude Code, and AI-optimized workflows
• Virtualization - QEMU/KVM and Virt-Manager built-in
• Secure - FIDO2, fingerprint support, and encrypted storage
• Developer Focused - Neovim, mise, Rust, Go, and essential tools
• Hardware Support - NVIDIA, Intel, AMD, Apple Silicon, Framework, Dell XPS, Surface
• Multi-Node Cluster Ready - Distributed AI/ML workloads across 1-1000+ nodes

System Requirements

• CPU: 64-bit x86 or ARM processor
• RAM: 4GB minimum, 8GB recommended
• Storage: 25GB minimum
• Graphics: Intel, AMD, or NVIDIA GPU (Wayland supported)
• USB: Bootable USB drive (8GB+)

Installation

Quick Install

Boot from the AI Computer ISO and run:

curl -fsSL https://os.aicomputer.services/boot.sh | bash

Or clone manually:

git clone https://github.com/AIComputerServices/aicomputerOS.git ~/.local/share/aicomputer
cd ~/.local/share/aicomputer
./install.sh

Manual Installation Steps

1. Create Bootable USB

   # On Linux
   sudo dd if=ai-computer-latest.iso of=/dev/sdX bs=4M status=progress
   
   # On macOS
   sudo dd if=ai-computer-latest.iso of=/dev/diskN bs=4m

2. Boot from USB

   • Select "AI Computer" from the bootloader
   • Login with the live user (ai/ai)

3. Run Installation

   sudo ai-computer-install

4. Post-Installation

   • Restart and remove USB
   • Login with your new user
   • Run first-run setup: aicomputer-cmd-first-run

Usage

Commands

Command	Description
aicomputer-menu	Open main application menu
aicomputer-update	Update system and packages
aicomputer-theme-set <name>	Change system theme
aicomputer-install-vscode	Install VS Code
aicomputer-launch-screensaver	Start screensaver
aicomputer-lock-screen	Lock the screen
aicomputer-brightness-display <up|down>	Adjust brightness

Virtualization

Start using VMs:

# Launch Virt-Manager
virt-manager

# Or use QEMU directly
qemu-system-x86_64 -cdrom windows.iso -m 4G -boot d

Keyboard Shortcuts

Shortcut	Action
Super + Space	App launcher
Super + M	Audio switcher
Super + L	Lock screen
Ctrl + Print	Color picker
Print	Screenshot
Alt + Print	Screenrecord

Configuration

Themes

# List available themes
aicomputer-theme-list

# Apply a theme
aicomputer-theme-set nord

# Or via menu
aicomputer-menu theme

Fonts

# List available fonts
aicomputer-font-list

# Set a font
aicomputer-font-set "JetBrains Mono"

Package Management

# Install packages
aicomputer-pkg-install

# Install from AUR
aicomputer-pkg-aur-install

# Update system
aicomputer-update

Development

Creating a Migration

aicomputer-dev-add-migration --no-edit
# Edit the generated migration file

Building ISO

# Install build dependencies
yay -S archiso

# Build
sudo mkarchiso -v -o ./out ai-computer-profiles/

Troubleshooting

Display Issues

# Restart GNOME
sudo systemctl restart gdm

# Check GPU status
aicomputer-hw-intel    # Intel
aicomputer-hw-asus-rog # NVIDIA/AMD

Audio Issues

# Restart PipeWire
systemctl --user restart pipewire pipewire-pulse

# Open audio controls
aicomputer-launch-audio

Network Issues

# Restart NetworkManager
sudo systemctl restart NetworkManager

# Check status
nmcli device status

Recovery

# Reinstall configs
aicomputer-reinstall-configs

# Full reinstall
aicomputer-reinstall

Uninstall

# Via AI Computer menu
aicomputer-menu system
# Select "Uninstall AI Computer"

# Manual
sudo rm -rf ~/.local/share/aicomputer ~/.config/aicomputer ~/.local/state/aicomputer

Support

• Documentation: docs.aicomputer.services
• Issues: github.com/AIComputerServices/aicomputerOS/issues
• Website: aicomputer.org

License

MIT License - see LICENSE

Cluster Mode

AI Computer OS supports multi-node cluster deployment for distributed AI/ML workloads.

Architecture

Component	Description
Node Roles	head, worker, hybrid, edge
Network	WireGuard mesh overlay
Discovery	mDNS (local), Consul (enterprise)
Storage	BTRFS + Longhorn/Ceph

Cluster Commands

# Initialize node (auto-runs on first boot)
aicomputer-cluster-node-init [role]

# Join cluster
aicomputer-cluster-join <peer-ip>

# Check status
aicomputer-cluster-status

# Leave cluster
aicomputer-cluster-leave

Supported Workloads

• Inference: vLLM, Triton, TensorFlow Serving
• Training: Ray, PyTorch DDP, KubeFlow
• Storage: Longhorn, Rook/Ceph
• Orchestration: K3s, Kubernetes