AuriOS Documentation

AuriOS is a minimal, educational operating system kernel for the x86 (i686) architecture, written from scratch in C and Assembly. The project explores the fundamentals of OS development: memory management, interrupt handling and hardware interaction.

Requirements

Install the cross-compilation toolchain and QEMU to build AuriOS from source.

Building

Build the kernel and run it in an emulator.

The shell

Explore the interactive AuriOS shell.

Architecture

Understand how the kernel works internally, from boot to shell.

Project structure

Browse the repository layout and find your way around the source tree.

Command reference

Every built-in shell command.

Contributing

Join the project and submit your first PR.

Current features (v0.2)

• System components: GDT, IDT with ISR handlers, PIC remapping, Multiboot loader.
• Memory management: physical memory manager (PMM), paging (MMU), dynamic heap allocation (malloc / free).
• Hardware drivers: keyboard, programmable interval timer (PIT), serial output, VGA framebuffer / terminal.
• Interface: interactive shell with command history and colors.

Who this documentation is for

• OS developers curious about the low-level workings of an x86 kernel.
• Contributors who want to build, test and evolve AuriOS.
• Students learning systems programming.

AuriOS is an open project released under the MIT license. The source code is available on GitHub. See the Contributing page to get involved.