🖥️ AOS

Modern 64-bit Educational Kernel - Complete Technical Documentation

Welcome to AOS Documentation

AOS is a powerful x86_64 monolithic kernel built from scratch for learning OS internals and AI integration. This comprehensive documentation covers every component, from bootloader to network stack, with detailed explanations and code walkthroughs suitable for both learning and production reference.

Whether you're a student exploring operating system concepts, a developer implementing kernel features, or someone interested in how modern systems work at the lowest level, you'll find everything you need here.

30+
Core Modules
15K+
Lines of Code
2
Boot Methods
100%
Open Source

✨ Key Features

Direct x86_64 Assembly

Hand-crafted GDT, IDT, and paging tables

🚀

Modern Boot Support

UEFI and BIOS compatibility with Multiboot 2

💾

Advanced Memory

4-level paging, bitmap PMM, dynamic heap

⌨️

Complete I/O

APIC routing, ATA/AHCI, keyboard, VGA

📁

Functional Filesystem

FAT32 with GPT/MBR partition support

🔄

Multitasking

Round-robin scheduler with context switching

🌐

Network Stack

Embedded lwIP TCP/IP with multiple NIC drivers

🤖

AI Foundation

Tokenization and LLM inference support

📚 Documentation Sections

🏗️

Architecture & Boot

Learn how the CPU boots and transitions to 64-bit mode, including segmentation, descriptor tables, and bootloader interaction.

💾

Memory Management

Explore physical and virtual memory management, paging structures, and dynamic memory allocation for the kernel.

Interrupts & I/O

Understand how the system handles hardware interrupts, APIC controllers, timers, and direct I/O port access.

🖲️

Device Drivers

Deep dive into hardware drivers for storage, input, output, and bus enumeration with code examples.

📁

Filesystem

Understand FAT32 filesystem implementation, partition management, and file operations.

⚙️

Core Systems

Explore kernel initialization, task management, scheduling, and the command-line shell.

🌐

Networking

Discover the embedded lwIP TCP/IP stack and network interface drivers.

🎓 Learning Paths

Choose your journey based on experience level:

🌱 Beginner Path (3 weeks)

  1. Bootloader & Multiboot
  2. Global Descriptor Table (GDT)
  3. Physical Memory Basics
  4. Interrupts Overview
  5. VGA Text Output
  6. Keyboard Input

📈 Intermediate Path (4 weeks)

  1. Deep Virtual Memory
  2. APIC Routing
  3. Task Scheduling
  4. ATA Storage
  5. FAT32 Filesystem
  6. Shell Commands

⚡ Advanced Path (6+ weeks)

  1. Kernel Allocator
  2. lwIP Network Stack
  3. System Calls
  4. User Mode Ring 3
  5. SMP Multi-core
  6. Advanced Scheduling

Ready to Explore?

Start with our comprehensive guides, study the implementation details, and build your understanding of modern OS architecture.

Begin Learning →