⬇ Download YoxOS

Get the latest release and start your Yoruba-native computing experience.

YoxOS 1.0 "Ipinlẹ"

Stable Release — Based on Ubuntu 22.04 LTS

File: yoxos-1.0-amd64.iso
Size: 4.6 GB
Architecture: x86_64 (64-bit)
Boot: BIOS + EFI Hybrid
Kernel: HWE 6.8.0-101-generic
Desktop: GNOME (Yoruba)
💡 ISO Contents

The ISO includes the complete YoxOS system with all AI models pre-loaded (3GB), Yoruba translations, AfrikGPT-Office, 18-layer security, and the Ubiquity installer. No additional downloads required.

⬇ Download YoxOS 1.0 ISO (4.6 GB)
Standalone Apps

Individual Applications

Don't need the full OS? Download AfrikGPT-Office and Yoruba AI Assistant as standalone apps for your existing Windows or Mac system.

📄

AfrikGPT-Office

Yoruba Office Suite for Windows & Mac

A fully branded office productivity suite based on LibreOffice with comprehensive Yoruba language menus. Includes Writer, Calc, Impress, Draw, and Base.

ModulesWriter, Calc, Impress, Draw, Base
LanguageYoruba UI + English fallback
Formats.docx, .xlsx, .pptx, .odt, .pdf
Size~800 MB

Requirements: Windows 10+ or macOS 11+, 4 GB RAM, 2 GB disk space

🤖

Yoruba AI Assistant

Offline AI for Translation, TTS, STT & Pronunciation

Powerful offline AI assistant with English↔Yoruba translation, natural Yoruba text-to-speech, speech-to-text transcription, and interactive pronunciation guide for learning Yoruba letters and tones. 100% private — no internet needed.

FeaturesTranslation, TTS, STT, Pronunciation Guide
AI ModelsNLLB-200, MMS-TTS, Whisper
Privacy100% Offline — No data leaves your PC
Size~3.5 GB (includes AI models)

Requirements: Windows 10+ or macOS 11+, 8 GB RAM, 5 GB disk space, 64-bit CPU with SSE4.2+

📦 All Downloads at a Glance

Product Platforms Size Includes
YoxOS 1.0 "Ipinlẹ" Bootable ISO (BIOS + EFI) 4.6 GB Complete OS + All AI + Office + Security
AfrikGPT-Office Windows 10+, macOS 11+ ~800 MB Writer, Calc, Impress, Draw, Base (Yoruba UI)
Yoruba AI Assistant Windows 10+, macOS 11+ ~3.5 GB Translation + TTS + STT (3 AI models, offline)
Requirements

System Requirements

YoxOS runs on most modern 64-bit computers. Here are the minimum and recommended specifications.

📌 Minimum Requirements
  • 💻
    Processor: 64-bit (x86_64/amd64) dual-core CPU, 1.5 GHz or faster
  • 💾
    RAM: 4 GB (AI features may be slow with less)
  • 💿
    Storage: 25 GB free disk space
  • 🖨
    Display: 1024 x 768 resolution
  • 🔌
    Boot: USB port or DVD drive for installation
  • 💻
    Firmware: BIOS or UEFI
⭐ Recommended Specifications
  • 💻
    Processor: 64-bit quad-core CPU with SSE4.2+ (Intel i5/AMD Ryzen 5 or better)
  • 💾
    RAM: 8 GB or more (for smooth AI performance)
  • 💿
    Storage: 50 GB SSD (SSD recommended for faster AI model loading)
  • 🖨
    Display: 1920 x 1080 (Full HD) or higher
  • 🎤
    Audio: Sound card + microphone (for TTS/STT features)
  • 🔌
    USB: USB 3.0 flash drive (8GB+) for fastest boot

💿 Disk Space Breakdown

ComponentSizeNotes
Base System (Ubuntu 22.04)~6 GBCore OS, GNOME desktop, utilities
AI Models~3 GBNLLB-200 (2.4GB), Whisper (462MB), MMS-TTS (139MB)
AfrikGPT-Office~800 MBFull office suite with 5 modules
Yoruba Translations~50 MB9 .mo files, .desktop translations, fonts
Security Tools~200 MBUFW, AppArmor, Fail2Ban, AIDE, rkhunter, chkrootkit
Python + PyTorch~2 GBAI runtime environment (CPU version)
Swap Space~4 GBRecommended for AI model loading
Total Installed~16 GBPlus 4GB swap = ~20GB minimum partition
Preparation

Creating Bootable Media

Choose your platform and follow the steps to create a bootable USB drive or configure a virtual machine.

💾 USB Flash Drive (for Real Hardware)

You will need a USB flash drive of at least 8GB. All data on the drive will be erased.

Using Rufus (Windows)

  1. Download Rufus (free, portable, no installation needed)
  2. Insert your USB drive and open Rufus
  3. Under Device, select your USB drive
  4. Click SELECT and choose the yoxos-1.0-amd64.iso file
  5. Set Partition scheme to GPT for UEFI systems, or MBR for legacy BIOS
  6. Set File system to FAT32 (default)
  7. Click START and wait for completion (5-15 minutes)
  8. Boot your computer from the USB drive
💡 Tip for UEFI + BIOS

If you're unsure whether your computer uses UEFI or BIOS, select GPT partition scheme. Most computers from 2012+ use UEFI. The YoxOS ISO is a hybrid image that supports both.

Using balenaEtcher (Windows/Mac/Linux)

  1. Download balenaEtcher for your platform
  2. Insert your USB drive and open Etcher
  3. Click Flash from file and select yoxos-1.0-amd64.iso
  4. Click Select target and choose your USB drive
  5. Click Flash! and wait for completion
  6. Boot your computer from the USB drive

Using dd (Linux/macOS Terminal)

⚠ Warning

The dd command writes directly to the device. Double-check the device name to avoid data loss. Use lsblk to identify your USB drive.

Terminal
# Identify your USB drive (e.g., /dev/sdb)
lsblk

# Write the ISO to the USB drive (replace /dev/sdX)
sudo dd if=yoxos-1.0-amd64.iso of=/dev/sdX bs=4M status=progress oflag=sync

# Sync and eject
sync
sudo eject /dev/sdX
Virtual Machines

Installing in a Virtual Machine

Test YoxOS safely in a virtual machine before installing on real hardware. We support all major hypervisors.

📦 Oracle VirtualBox

VirtualBox is free, open-source, and works on Windows, macOS, and Linux.

Recommended VM Settings

SettingValue
TypeLinux
VersionUbuntu (64-bit)
RAM4096 MB (minimum) / 8192 MB (recommended)
CPU Cores2 (minimum) / 4 (recommended)
Disk Size30 GB (minimum) / 50 GB (recommended)
Disk TypeVDI, Dynamically allocated
GraphicsVMSVGA, 128 MB Video Memory
NetworkNAT (default) or Bridged
AudioEnable for TTS/STT features
USBUSB 3.0 (xHCI) if available
EFIEnable EFI (recommended) or leave unchecked for BIOS

Step-by-Step Setup

  1. Open VirtualBox and click New
  2. Name: "YoxOS", Type: "Linux", Version: "Ubuntu (64-bit)"
  3. Allocate at least 4096 MB RAM (8192 MB recommended for AI)
  4. Create a virtual hard disk (VDI, dynamically allocated, 50 GB)
  5. Open VM Settings > System > Enable EFI (optional but recommended)
  6. Settings > Display > Set Video Memory to 128 MB, select VMSVGA
  7. Settings > Storage > Add the ISO as an optical disc
  8. Settings > Audio > Enable audio output (for TTS)
  9. Click Start to boot from the ISO
  10. Select "Try YoxOS" or "Install YoxOS" from the GRUB menu
✔ VirtualBox Guest Additions

After installation, install VirtualBox Guest Additions for better performance, shared folders, and automatic screen resizing: sudo apt install virtualbox-guest-utils virtualbox-guest-x11

💻 VMware Workstation / Player

VMware provides excellent Linux guest support and performance.

Recommended VM Settings

SettingValue
Guest OSUbuntu 64-bit
RAM4 GB minimum / 8 GB recommended
Processors2 cores minimum / 4 cores recommended
Disk30 GB minimum / 50 GB recommended (SCSI)
Display3D acceleration enabled, 256 MB video RAM
NetworkNAT
Sound CardAuto detect (enable for TTS/STT)
FirmwareUEFI (recommended)

Step-by-Step Setup

  1. Open VMware and click Create a New Virtual Machine
  2. Select Installer disc image file (iso) and browse to the YoxOS ISO
  3. Guest OS: Linux, Version: Ubuntu 64-bit
  4. Allocate disk space (50 GB recommended, store as single file)
  5. Click Customize Hardware > Set RAM to 4-8 GB, CPUs to 2-4
  6. Enable sound card for AI voice features
  7. Click Finish and power on the VM
💡 VMware Tools

Install open-vm-tools for better integration: sudo apt install open-vm-tools open-vm-tools-desktop

☍ Microsoft Hyper-V

Hyper-V is built into Windows 10/11 Pro, Enterprise, and Education editions.

Enable Hyper-V

PowerShell (Admin)
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All

Recommended VM Settings

SettingValue
GenerationGeneration 2 (UEFI)
RAM4096 MB minimum / 8192 MB recommended
Dynamic MemoryEnabled (min 4096, max 8192)
Processors2 minimum / 4 recommended
Disk50 GB VHDX
Secure BootDisabled (or use Microsoft UEFI CA)
NetworkDefault Switch

Step-by-Step Setup

  1. Open Hyper-V Manager and click New > Virtual Machine
  2. Name: "YoxOS", select Generation 2
  3. Assign at least 4096 MB startup memory, enable Dynamic Memory
  4. Create a virtual hard disk (50 GB VHDX)
  5. Select Install an OS from a bootable image file and browse to the ISO
  6. Before starting: Go to Settings > Security > Uncheck Enable Secure Boot
  7. Settings > Processor > Set virtual processors to 2-4
  8. Connect and start the VM
⚠ Hyper-V Notes

For Generation 2 VMs, you must disable Secure Boot or add the YoxOS signing key. Audio passthrough requires Enhanced Session Mode. For STT/TTS features, consider using VirtualBox instead for easier audio configuration.

🐧 QEMU / KVM

QEMU with KVM acceleration provides near-native performance on Linux hosts.

Quick Start

Terminal
# Install QEMU and virt-manager (Ubuntu/Debian)
sudo apt install qemu-kvm libvirt-daemon-system virt-manager

# Create a disk image
qemu-img create -f qcow2 yoxos-disk.qcow2 50G

# Boot from ISO with KVM acceleration
qemu-system-x86_64 \
  -enable-kvm \
  -m 4096 \
  -smp 4 \
  -drive file=yoxos-disk.qcow2,format=qcow2 \
  -cdrom yoxos-1.0-amd64.iso \
  -boot d \
  -vga virtio \
  -display gtk \
  -soundhw hda \
  -usb -device usb-tablet

Using virt-manager (GUI)

  1. Open Virtual Machine Manager (virt-manager)
  2. Click Create New VM > Local install media (ISO)
  3. Browse to the YoxOS ISO, OS type: Ubuntu 22.04
  4. Set RAM to 4096 MB, CPUs to 4
  5. Create 50 GB disk image
  6. Check Customize configuration before install
  7. Set Firmware to UEFI (OVMF) for EFI boot
  8. Add sound device for TTS/STT features
  9. Click Begin Installation
Hardware

Installing on Real Hardware

Install YoxOS on your laptop or desktop computer for the best performance experience.

Pre-Installation Checklist

⚠ Important

Installing YoxOS on real hardware will modify your disk. Back up any important data before proceeding. You can also dual-boot alongside your existing operating system.

  • Back up all important data on the target drive
  • Create a bootable USB using Rufus, Etcher, or dd (see above)
  • Note your Wi-Fi password if connecting wirelessly
  • Ensure your computer meets the minimum requirements
  • If dual-booting, ensure you have at least 25GB of free unpartitioned space

Installation Steps

  1. Boot from USB: Insert the USB drive and restart your computer. Press F12, F2, Esc, or Del to access the boot menu. Select your USB drive.
  2. GRUB Menu: Select "Install YoxOS" for direct installation, or "Try YoxOS" to test in live mode first.
  3. Language: The installer will default to Yoruba. You can change this if needed.
  4. Keyboard: The Yoruba keyboard layout is pre-selected. Keep it or add additional layouts.
  5. Installation Type:
    • Erase disk and install YoxOS — Uses the entire disk (simplest option)
    • Install alongside — Dual-boot with your existing OS
    • Something else — Manual partitioning (advanced users)
  6. User Setup: Create your username and password. The installer will also ask for your computer name and timezone.
  7. Installation: The process takes 15-30 minutes depending on your hardware. Files are copied, GRUB is installed, and the system is configured.
  8. Reboot: Remove the USB drive when prompted and restart. YoxOS will boot from your hard drive.

Recommended Partition Layout

If you choose manual partitioning ("Something else"), use this layout:

Mount PointTypeSizePurpose
/boot/efiEFI System512 MBEFI boot loader (UEFI only)
/ext425-40 GBRoot filesystem
/homeext4Remaining spaceUser files and data
swapswap4-8 GBVirtual memory (important for AI)
✔ After Installation

After installation, YoxOS is ready to use immediately. All AI models are pre-installed, Yoruba translations are active, and 18 security layers are enabled. No additional setup required!

Configuration

Post-Installation Configuration

Optional steps to customize and optimize your YoxOS installation.

1. Change Default Password

If you used the live session, change the default password immediately:

Terminal
# Change your password
passwd

# Or use the Settings app: Settings > Users > Password

2. Connect to Wi-Fi

Click the system menu (top-right corner) > Wi-Fi > Select your network and enter the password. YoxOS supports WPA2/WPA3 encrypted networks.

3. Update the System

Connect to the internet and run:

Terminal
sudo apt update && sudo apt upgrade -y

4. Install Additional Drivers

YoxOS includes basic GPU drivers. For NVIDIA GPUs, install proprietary drivers:

Terminal
# List available drivers
ubuntu-drivers devices

# Install recommended driver
sudo ubuntu-drivers autoinstall

# Reboot
sudo reboot

5. Configure Printer

Open Settings > Printers. Most USB and network printers are detected automatically. CUPS printer management is available at http://localhost:631.

6. Enable Bluetooth

Bluetooth is supported via the system menu. Click the Bluetooth icon to pair devices. If Bluetooth doesn't appear, ensure your hardware is supported:

Terminal
# Check Bluetooth hardware
rfkill list bluetooth
sudo systemctl status bluetooth

7. Set Up TLP for Laptops

TLP is pre-installed for laptop battery optimization. Check its status:

Terminal
sudo tlp-stat -s
Verification

Verify Your Installation

Run these checks to confirm everything is working correctly.

Terminal - Run all verification checks
# Check system info
uname -a
# Expected: Linux yoxos 6.8.0-101-generic ...

# Check locale
locale
# Expected: LANG=yo_NG.UTF-8

# Check Yoruba characters render correctly
echo "ẹ ọ ṣ á à ā ẹ́ ọ̀ - Yoruba chars OK"

# Check security status
yoxos-security status
# Expected: 18/18 security layers active

# Check AI models
ls /opt/yoxos/models/
# Expected: tts/ stt/ translation/

# Test AI assistant
yoxos-ai
# Expected: GTK3 GUI opens with 3 tabs

# Check firewall
sudo ufw status
# Expected: Status: active, deny incoming, allow outgoing

# Check AfrikGPT-Office
libreoffice --version
# Expected: LibreOffice 7.x

Need Help?

Check the documentation for detailed guides, troubleshooting, and frequently asked questions.

📖 View Documentation 💻 Check Compatibility