Pyohya OS

Pyohya OS is a tiny x86_64 hobby operating system starter. Version 0.3 boots through Limine, opens a framebuffer desktop preview, draws a taskbar and terminal window, shows a PS/2 mouse cursor, polls keyboard/mouse input, and runs a minimal command shell.

This is not a Windows-compatible OS yet. It is a small native kernel that can grow toward a Windows-like interface later.

Requirements

Use WSL Ubuntu for the smoothest build path:

sudo apt update
sudo apt install -y clang lld make xorriso mtools qemu-system-x86 git curl

Or use MSYS2 UCRT64 on Windows:

pacman -Syu
pacman -S --needed base-devel git curl make xorriso mingw-w64-ucrt-x86_64-mtools mingw-w64-ucrt-x86_64-clang mingw-w64-ucrt-x86_64-lld mingw-w64-ucrt-x86_64-qemu

Limine is fetched automatically by make from the binary release branch set in Makefile. The default is v11.4.0, which was the current public point release available from the official GitHub mirror when this project was scaffolded.

Build

From PowerShell:

.\scripts\build.ps1

From PowerShell with MSYS2:

.\scripts\setup-msys2.ps1
.\scripts\build-msys2.ps1

From WSL:

make iso

The bootable image is written to:

dist/pyohya-os.iso

Run

From PowerShell:

.\scripts\run.ps1

From PowerShell with MSYS2:

.\scripts\run-msys2.ps1

From WSL:

make run

Shell Commands

• help shows available commands.
• about shows version and bootloader information.
• clear clears the framebuffer console.
• echo <text> prints text.
• mem summarizes the Limine memory map.
• reboot asks the keyboard controller to reset the machine.