β
Local AI (Llama/Ollama) - Offline-capable after initial model download
β
AI Taskbar Integration - Click anytime to chat
β
Agentic AI - Completes tasks FOR you
β
Auto Driver Detection - Like Windows
β
System/Admin/User Settings - Complete UI
β
Theme Selector - 7+ Professional Themes
β
AI Browser - Opera-style with built-in AI
β
Aura Life OS - J.A.R.V.I.S. for your entire life
β
All 20 GitHub Innovations - Fully integrated
Note: AI models (~4GB) are downloaded on first use. System works without AI features.
# Test the Ultimate Complete Edition:
qemu-system-x86_64 -cdrom aurora-os-ultimate-complete.iso -m 4G -smp 2
# Commands inside Aurora OS:
aurora-ai "fix my wifi" # Local AI assistant
aurora-aura # Start Life OS (J.A.R.V.I.S.)
aurora-settings # Open settings
aurora-theme catppuccin # Change themeπ ULTIMATE FEATURES GUIDE β Read This First!
οΏ½ PUBLIC VERIFICATION GUIDE π― Verify Everything!
οΏ½π Installation & Deployment
π₯ Download ISO
Boot β Run Apps β Manage Files
Boot β Understand YOU β Anticipate Needs β Complete Tasks β Manage Your LIFE
Key Innovations:
- π§ Local AI - Llama model runs ON your machine (no cloud, no subscription)
- π― Agentic AI - Doesn't just chat, it DOES things for you
- π Aura Life OS - Manages calendar, health, finance, goals across all life domains
- π Auto Drivers - Detects and installs drivers automatically (Windows-style)
- βοΈ Complete Settings - System, Admin, and User panels
- π¨ 7+ Themes - Nord, Catppuccin, Tokyo Night, Windows 11 style, macOS style
- π AI Browser - Built-in AI for search, summaries, translation
Read the full feature guide: ULTIMATE_FEATURES.md
Current Release: v0.3.0-alpha (December 13, 2025)
π Download from GitHub Releases
Available Editions:
- Complete Edition (519 MB) - Full system with Python stdlib + AI features β RECOMMENDED
- aurora-os-ultimate-complete.iso
- SHA256:
f3190ed23314773a75f0425a336368246d8779ceb4e314e4b4d6274c39a74b8d
- Framework Lite (42 MB) - Minimal system with AI framework scripts only
- Kernel Binary - Compiled Linux 6.1.115 LTS
- vmlinuz (5.7 MB)
Note: Currently, Complete Edition includes all features. The AI capabilities (8 small Python scripts) are runtime-optional. AI models (~4GB) are not included - they can be downloaded on first boot or skipped to use the base system.
π Verification: All ISOs include SHA256 and MD5 checksums. See PUBLIC_VERIFICATION.md for complete verification steps.
- Linux Kernel 6.1.115 LTS (5.7 MB compiled)
- Python 3.12 + complete standard library (54 MB)
- Init System: systemd (PID 1) with Aurora services as systemd units
- System Libraries: glibc, libm, libdl, libpthread, libz
- BusyBox: 150+ Unix utilities
- Aurora AI Control Plane + MCP Nervous System
- Local AI (Llama/Ollama integration) - Offline-capable after model download (~4GB, optional)
- AI Taskbar - Click-to-chat AI assistant
- Agentic AI - Task completion automation
- Auto Driver Detection - Windows-style plug-and-play
- System/Admin/User Settings - Complete configuration UI
- Theme Manager - 7+ professional themes
- AI Browser - Opera-style with built-in AI
- Aura Life OS - J.A.R.V.I.S. life management system
- All 20 GitHub Innovations - Fully integrated
- GRUB Bootloader with multiple boot modes
Init Sequence: GRUB β Linux 6.1.115 β systemd (PID 1) β Aurora services (as systemd units)
π Complete Feature List: ULTIMATE_COMPLETE_STATUS.md
Aurora OS can be deployed in multiple ways depending on your needs. Choose the option that best fits your use case.
Perfect for: Development, testing, and evaluation
-
Download VirtualBox: https://www.virtualbox.org/wiki/Downloads
-
Create New Virtual Machine:
- Name: Aurora OS - Type: Linux - Version: Other Linux (64-bit) - Memory: 4096 MB (4 GB minimum, 8 GB recommended) - Hard disk: Create virtual hard disk (20 GB+) -
Configure VM Settings:
- Name: Aurora OS Ultimate Complete - Type: Linux - Version: Other Linux (64-bit) - Memory: 4096 MB (4 GB minimum, 8 GB recommended) - Hard disk: Create virtual hard disk (20 GB+) -
Attach ISO:
- System β Processor: 2 CPUs (4 recommended) - System β Acceleration: Enable VT-x/AMD-V - Storage β Controller IDE: Add aurora-os-ultimate-complete.iso as CD/DVD - Display β Video Memory: 128 MB - Network β Adapter 1: NAT or Bridged -
Boot Aurora OS:
- Start the VM
- Aurora OS will boot from the ISO
- Follow on-screen instructions
VirtualBox Commands (CLI):
# Create VM
VBoxManage createvm --name "Aurora-OS" --ostype "Linux_64" --register
# Configure VM
VBoxManage modifyvm "Aurora-OS" --memory 4096 --cpus 2 --vram 128
VBoxManage modifyvm "Aurora-OS" --nic1 nat --nictype1 82540EM
VBoxManage modifyvm "Aurora-OS" --boot1 dvd --boot2 disk
# Add storage
VBoxManage storagectl "Aurora-OS" --name "IDE" --add ide
VBoxManage storageattach "Aurora-OS" --storagectl "IDE" --port 0 --device 0 --type dvddrive --medium aurora-os-ultimate-complete.iso
# Start VM
VBoxManage startvm "Aurora-OS"Perfect for: Enterprise testing, development environments
-
Download VMware:
- Workstation (Windows/Linux): https://www.vmware.com/products/workstation-pro.html
- Fusion (macOS): https://www.vmware.com/products/fusion.html
-
Create New Virtual Machine:
- File β New Virtual Machine
- Choose "Custom (advanced)"
- Select "I will install the operating system later"
- Guest OS: Linux β Other Linux 5.x or later kernel 64-bit
-
Configure VM:
- Memory: 4 GB minimum (8 GB recommended) - Processors: 2 cores (4 recommended) - Network: NAT or Bridged - Hard Disk: 20 GB minimum -
Attach ISO:
- VM Settings β CD/DVD (IDE)
- Check "Connect at power on"
- Use ISO image file: aurora-os.iso
-
Boot:
- Power on the virtual machine
- Aurora OS will boot automatically
Perfect for: Quick testing, CI/CD, headless servers
# Ubuntu/Debian
sudo apt install qemu-system-x86
# Fedora/RHEL
sudo dnf install qemu-system-x86
# macOS
brew install qemu
# Arch Linux
sudo pacman -S qemu-fullqemu-system-x86_64 \
-cdrom aurora-os.iso \
-m 4G \
-smp 2 \
-enable-kvm# Create virtual disk (optional for persistence)
qemu-img create -f qcow2 aurora-disk.qcow2 20G
# Boot with virtual disk and more options
qemu-system-x86_64 \
-cdrom aurora-os.iso \
-drive file=aurora-disk.qcow2,format=qcow2 \
-m 8G \
-smp cores=4 \
-enable-kvm \
-cpu host \
-vga virtio \
-display gtk \
-net nic,model=virtio \
-net user \
-boot order=dqemu-system-x86_64 \
-cdrom aurora-os.iso \
-m 4G \
-smp 2 \
-nographic \
-serial stdioqemu-system-x86_64 \
-cdrom aurora-os.iso \
-m 4G \
-smp 2 \
-vnc :1
# Connect with VNC client to: localhost:5901QEMU Options Explained:
-m 4G: Allocate 4GB RAM-smp 2: Use 2 CPU cores-enable-kvm: Enable hardware virtualization (Linux hosts)-boot order=d: Boot from CD-ROM first-cpu host: Use host CPU features-vga virtio: Better graphics performance
Perfect for: Physical hardware testing, installation, live system
# WARNING: This will erase all data on the USB drive!
# Replace /dev/sdX with your actual USB device (e.g., /dev/sdb)
# 1. Find your USB device
lsblk
# 2. Unmount the USB drive (if mounted)
sudo umount /dev/sdX*
# 3. Write ISO to USB
sudo dd if=aurora-os.iso of=/dev/sdX bs=4M status=progress oflag=sync
# 4. Verify write
syncOption A: Rufus (Recommended)
- Download Rufus: https://rufus.ie/
- Insert USB drive (4GB+ required)
- Select aurora-os.iso
- Partition scheme: MBR
- Target system: BIOS or UEFI
- Click START
Option B: Balena Etcher
- Download Etcher: https://www.balena.io/etcher/
- Select aurora-os.iso
- Select target USB drive
- Flash!
Option C: Windows Command Line
# Run as Administrator
# List disks
wmic diskdrive list brief
# Use Win32DiskImager or similar tool
# OR use WSL with dd command above- Insert USB drive into target computer
- Restart computer
- Enter BIOS/UEFI (usually F2, F12, DEL, or ESC during boot)
- Change boot order to boot from USB first
- Save and exit
- Aurora OS will boot from USB
Perfect for: Production use, dedicated systems
- Computer with 4GB+ RAM (8GB+ recommended)
- 20GB+ storage space
- USB drive with Aurora OS (see Option 4)
- Backup of existing data (if dual-booting)
-
Boot from USB:
- Insert Aurora OS USB drive
- Boot from USB (see Option 4)
-
Choose Installation Mode:
- Select "Install Aurora OS" from GRUB menu
- Or run:
sudo aurora-installerfrom live system
-
Partition Disk:
# Automatic (full disk): sudo aurora-installer --auto --disk /dev/sda # Manual partitioning: sudo aurora-installer --manual # Dual-boot (preserve existing OS): sudo aurora-installer --dual-boot
-
Installation Options:
- Desktop: Full graphical environment
- Server: Minimal installation
- Developer: Includes development tools
- Enterprise: With management features
-
Post-Installation:
- Remove USB drive
- Reboot system
- Aurora OS boots from hard drive
- Processor: 64-bit x86 CPU (2+ cores recommended)
- RAM: 4 GB minimum (8 GB+ recommended)
- Storage: 20 GB minimum (50 GB+ recommended)
- Graphics: Any GPU (VirtIO supported)
- Network: Ethernet or WiFi
- Processor: Quad-core 2.0 GHz+
- RAM: 16 GB+
- Storage: 100 GB+ SSD
- Graphics: Dedicated GPU
- Network: Gigabit Ethernet
Perfect for: Enterprise, development teams, CI/CD
# Upload ISO to S3
aws s3 cp aurora-os.iso s3://your-bucket/
# Create VM import task
aws ec2 import-image \
--description "Aurora OS" \
--disk-containers "Format=raw,UserBucket={S3Bucket=your-bucket,S3Key=aurora-os.iso}"# Upload to Cloud Storage
gsutil cp aurora-os.iso gs://your-bucket/
# Create custom image
gcloud compute images create aurora-os \
--source-uri=gs://your-bucket/aurora-os.iso# Upload VHD (convert ISO first)
az storage blob upload \
--account-name youraccount \
--container-name images \
--name aurora-os.vhd \
--file aurora-os.vhdPerfect for: Development, testing Aurora components
# Dockerfile for Aurora OS development
FROM ubuntu:24.04
# Install QEMU
RUN apt-get update && apt-get install -y qemu-system-x86
# Copy Aurora OS ISO
COPY aurora-os.iso /aurora-os.iso
# Run Aurora OS
CMD ["qemu-system-x86_64", "-cdrom", "/aurora-os.iso", "-m", "4G", "-nographic"]Build and run:
docker build -t aurora-os .
docker run -it --privileged aurora-osAurora OS provides multiple boot modes via GRUB:
- Aurora OS (Normal Boot) - Standard boot with full features
- Aurora OS (Safe Mode) - Boot with minimal drivers
- Aurora OS (Debug Mode) - Boot with verbose logging
- Aurora OS (Recovery Mode) - System recovery and repair
- Memory Test - Hardware memory diagnostics
# Edit GRUB entry (press 'e' at boot menu)
# Add parameters to kernel line:
aurora.debug=1 # Enable debug mode
aurora.safe=1 # Safe mode
aurora.noacpi=1 # Disable ACPI
aurora.nomodeset=1 # Disable kernel mode setting
aurora.recovery=1 # Recovery mode# Check SHA256 checksum
sha256sum aurora-os.iso
# Should match: 9140badda5ff8ed09de31e0adcd60dc969c478ab9c7f8a899935f369e5278a8e
# Check MD5 (if provided)
md5sum aurora-os.iso- ISO boots successfully
- GRUB menu appears
- Kernel loads without errors
- System reaches shell/desktop
- Network connectivity works
- Python runtime available
- Aurora components load
- Check BIOS settings: Ensure virtualization is enabled (VT-x/AMD-V)
- Verify ISO: Check SHA256 checksum matches
- Try different boot mode: Legacy BIOS vs UEFI
- Increase RAM: Minimum 4GB required
# KVM permission denied
sudo chmod 666 /dev/kvm
# OR run without KVM:
qemu-system-x86_64 -cdrom aurora-os.iso -m 4G # (no -enable-kvm)
# No display
# Use -display gtk or -display sdl
qemu-system-x86_64 -cdrom aurora-os.iso -m 4G -display gtk- Enable VT-x/AMD-V in BIOS
- Install VirtualBox Extension Pack
- Increase video memory to 128MB
- Try different graphics controller (VMSVGA)
- Disable Secure Boot in BIOS
- Check boot order in BIOS
- Try different USB port (USB 2.0 vs 3.0)
- Re-create bootable USB with different tool
- System will boot to Aurora shell
- Default credentials (if required):
- Username:
aurora - Password:
aurora
- Username:
sudo aurora-updatesudo aurora-pkg install <package-name>aurora-ai-configAurora OS transforms computing from a tool-based paradigm to a partnership paradigm. It's not just an operating systemβit's like having a senior systems engineer, productivity expert, and life coach living inside your computer.
"The best computer is not the one that runs the fastest, but the one that understands you the best."
- AI as Control Plane: AI directs system operations, not just enhances them
- Proactive Intelligence: Anticipates needs and prevents problems
- Continuous Learning: System improves over time through experience
- Explainable Decisions: Every AI action is transparent and understandable
- Context Protocol: Complete system context through standardized MCP
- Real-time Intelligence: Context flows between all system components
- Unified Understanding: Holistic view of user, system, and environment
- Developer Ecosystem: Rich MCP provider ecosystem for extensibility
- Holistic Life Management: Work, health, finance, relationships, personal growth
- Cross-Domain Optimization: Understands interconnections between life areas
- Goal Decomposition: Breaks life goals into actionable steps
- Wellness Intelligence: Proactive health and wellbeing support
- AI-Enhanced Protection: Machine learning augments traditional security
- Explainable Security: Every security decision includes clear rationale
- Autonomous Defense: System prevents attacks before they succeed
- Privacy-First: All processing happens locally by default
- Natural Language: Speak or type naturally instead of clicking menus
- Progressive Disclosure: Information depth adapts to user needs
- Visual Reasoning: AI explains its thinking through visual overlays
- Multi-Modal: Speech, text, gestures, and contextual understanding
aurora-os/
βββ README.md # This file
βββ LICENSE # Open source license
βββ CONTRIBUTING.md # Contribution guidelines
βββ SECURITY.md # Security policy
βββ docs/ # Comprehensive documentation
βββ kernel/ # Linux kernel with AI extensions
β βββ ai_extensions/ # AI-enhanced kernel modules
βββ system/ # Aurora system services
β βββ ai_control_plane/ # AI control plane components
βββ mcp/ # MCP nervous system
β βββ system/ # Core MCP implementation
βββ desktop/ # Aurora desktop environment
βββ aura/ # Aura Life OS integration
βββ security/ # Security framework
βββ enterprise/ # Enterprise features
βββ testing/ # Test suites and validation
βββ tools/ # Development and deployment tools
βββ examples/ # Examples and demonstrations
# Ubuntu/Debian
sudo apt update
sudo apt install -y build-essential qemu-system xorriso grub-common \
gcc make nasm flex bison libelf-dev libssl-dev \
cpio busybox-static bc# Clone the repository
git clone https://github.com/iTechSmartINC/Aurora-OS.git
cd Aurora-OS
# Build the bootable ISO (automatic)
bash tools/build_iso.sh
# Test in QEMU
qemu-system-x86_64 -cdrom aurora-os.iso -m 4G -enable-kvm# Build initramfs only
bash tools/create_initramfs.sh
# Build custom kernel
cd kernel/linux-6.1
make defconfig
make -j$(nproc)π Complete Build Documentation
- Architecture Design: Complete system architecture with 7-layer design
- Linux Kernel Integration: Linux 6.1.115 LTS with Aurora extensions
- Build System: Automated ISO generation with initramfs
- Component Specifications: Detailed specifications for all 50+ components
- AI Control Plane: Intent engine, context manager, autonomy core
- MCP Integration: Complete MCP nervous system design
- Security Framework: Zero-trust security with AI enhancement
- Implementation Roadmap: 48-month phased development plan
- Enterprise Readiness: Complete enterprise and government features
- Aura Life Integration: Holistic life management system
- Bootable ISO: 19MB bootable image with GRUB
- Development Infrastructure: Repository, CI/CD, build system
- Kernel Extensions: AI-enhanced scheduler and context manager
- MCP System: Core MCP host and built-in providers
- AI Control Plane: Intent engine and context management
- Desktop Shell: Basic Aurora desktop environment
- Testing Framework: Comprehensive testing infrastructure
- Core OS Development (Months 6-18)
- AI Integration (Months 12-24)
- MCP Ecosystem (Months 18-30)
- Aura Life Integration (Months 24-36)
- Enterprise & Polish (Months 30-48)
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β USER LAYER β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β AURA AI LIFE OS β CONVERSATIONAL INTERFACE β VISUAL OVERLAYS β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β AI CONTROL PLANE β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β INTENT ENGINE β’ CONTEXT MANAGER β’ AUTONOMY CORE β’ LEARNING β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β MCP NERVOUS SYSTEM β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β SYSTEM MCP HOST β’ CONTEXT PROVIDERS β’ PERMISSION GUARD β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β AURORA DESKTOP SHELL β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β AI-MEDIATED WINDOW MANAGER β’ INTELLIGENT FILE MANAGER β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β APPLICATION LAYER β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β LINUX APPS β’ CONTAINERS β’ WIN32 COMPAT β’ AI-NATIVE APPS β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β SYSTEM SERVICES LAYER β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β AI-AWARE SYSTEMD β’ PREDICTIVE I/O β’ CONTEXT-AWARE SCHEDULER β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β LINUX KERNEL (LTS) β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β AI KERNEL MODULES β’ ENHANCED SECURITY β’ OBSERVABILITY β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
- Linux development environment
- Python 3.8+
- GCC/Clang compiler
- Git
- CMake (for kernel modules)
# Clone the repository
git clone https://github.com/aurora-os/aurora-os.git
cd aurora-os
# Set up development environment
./tools/setup_dev_environment.sh
# Build the AI-enhanced kernel
make -C kernel build
# Build system services
make -C system build
# Run tests
make test# Build complete OS image
make build
# Run in virtual machine
make run-vm
# Or install on bare metal
sudo make installmake test# Kernel tests
make test-kernel
# AI control plane tests
make test-ai
# MCP system tests
make test-mcp
# Security tests
make test-security- Architecture Overview
- AI Control Plane
- MCP Integration
- Security Model
- Development Guide
- API Reference
We welcome contributions! See CONTRIBUTING.md for guidelines.
- Kernel Team: Linux kernel expertise with AI/ML integration
- AI/ML Team: Natural language processing, machine learning, computer vision
- Systems Team: System architecture, MCP, security, networking
- UX/Desktop Team: User experience, desktop environment, accessibility
- Operations Team: DevOps, QA, release engineering
- Enterprise Team: Enterprise features, compliance, certification
Aurora OS is licensed under the GNU General Public License v3.0 with additional provisions for commercial use.
Security is a core design principle. See SECURITY.md for our security policy and reporting procedures.
Aurora OS is designed for enterprise and government deployments:
- Sovereign Deployment: Complete data sovereignty and air-gap support
- Compliance Ready: FIPS, FedRAMP, HIPAA, GDPR compliance
- Classified Support: Multi-level security for classified information
- Enterprise Management: Centralized policy and device management
Aurora OS embodies the "Digital Operator" paradigm - computing that understands intent, anticipates needs, and collaborates on goals. It's not just about running faster; it's about understanding better.
The system combines:
- Windows polish with intuitive, consistent user experience
- Linux power with open-source transparency and security
- AI intelligence with proactive, contextual assistance
- Life integration with holistic personal and professional optimization
β Development infrastructure and team establishment β Architectural prototypes and validation π Initial kernel with AI extensions π Basic MCP system implementation
β³ Enhanced Linux kernel with AI extensions β³ System services layer implementation β³ Windows compatibility layer development β³ Basic desktop environment
β³ Complete AI control plane implementation β³ Natural language interface development β³ Learning and adaptation systems β³ Explainable AI decision framework
β³ MCP host core implementation β³ System context providers development β³ External MCP bridge and enterprise connectors β³ Developer ecosystem and SDK
β³ Life context integration across domains β³ Goal decomposition engine β³ Holistic wellness integration β³ Relationship intelligence system
β³ Enterprise and government features β³ Performance optimization and UX polish β³ Compliance certifications β³ Commercial deployment preparation
- Website: https://aurora-os.org
- Documentation: https://docs.aurora-os.org
- Community: https://community.aurora-os.org
- Issues: https://github.com/aurora-os/aurora-os/issues
- Security: security@aurora-os.org
Aurora OS builds upon the incredible work of:
- The Linux kernel community
- The open-source ecosystem
- AI/ML research communities
- Human-computer interaction researchers
- Enterprise security experts
Aurora OS: The Digital Operator - Your Intelligent Partner in Digital Life
"We don't just make computers faster; we make them understand you better."