iamdaven/miraos

MiraOS is an operating system written from scratch in C and Assembly, built as a learning project for understanding how operating systems work at a low level. It targets 64-bit x86 hardware and runs in a virtual machine or emulator. The project covers the core parts of what makes an operating system function. It includes a custom bootloader that loads the kernel directly without relying on GRUB, a kernel that sets up the fundamental CPU data structures (GDT and IDT), manages memory with paging and a simple heap allocator, and runs multiple tasks through a basic scheduler. There is a RAM-based virtual filesystem that stores files entirely in memory, basic networking hooks, and driver support for display, keyboard, mouse, and timers. A minimal graphical shell provides a simple interface. The codebase is organized into folders for each major subsystem: boot code, CPU and hardware setup, kernel core, drivers, filesystem, networking, interface, and shared utilities. The README describes the boot sequence as starting with a BIOS sector that displays a brief message and pauses while the kernel is loaded from outside before handing over control. This is a from-scratch educational project rather than a usable general-purpose operating system. It is intended to demonstrate and explore how the fundamental pieces of an OS fit together. The project is released under the GPL 3.0 license, which requires that any modified version you distribute must also be made available under the same terms.