System · XerisOS

boot/

Boot path

UEFI Legacy MBR + Stage-2 Secure Boot off A/B slots

Updater design →

src/core

Kernel

src/kernel.asm

Long mode

x86-64Kernel entryMain loop

src/core/idt.asm

IDT

InterruptsFaults

src/core/apic.c · smp.asm

APIC / SMP

SMP bring-upAP cores

src/core/mm.c · ram_alloc.asm

Memory

Physical allocatorHeap allocator

src/core/fat32.asm · fs.c · fs_journal.c

FAT32

FilesystemJournal

src/core/sched.c · scheduler.asm

Scheduler

Cooperative main loopTimer preemption gate

src/core/syscall.c · syscall_entry.asm

Syscalls

SYSCALL / SYSRETRing 3

src/core/elf.c

ELF loader

ET_EXECET_DYN · PIE

src/core/linux_compat.c

Linux compatibility layer

Linux x86-64 syscall ABIclone3seccomp BPF

src/drivers

Drivers

Device drivers by class, with their source files under src/drivers
Class	Devices	Source
NIC	Intel e1000 · Realtek RTL8125	nic_e1000.asm · rtl_nic.c
Storage	AHCI · NVMe	ahci.c · nvme.c
USB	xHCI	xhci.c
Audio	Intel HDA	hda.c
Input	PS/2 keyboard/mouse · I2C-HID touchpad	keyboard.asm · i2c_hid.c
Display	Linear framebuffer (UEFI GOP / VESA)	video.asm
Wi-Fi	MediaTek MT7920 Native driver	mt7920.c · mt7920_mcu.c · mt7920_wifi.c
Bus	PCI	pci.asm · pci_cache.c
Debug	Serial	serial.asm

src/net · src/crypto

Network stack

Also in src/net

dhcp.c net_icmp.c sntp.c tls_server.asm tcp_listener.c firewall.c wifi.c wpa.c sae.c updater.c xeris_ed25519.c

Security →

src/gui · src/apps

Desktop

src/gui/window_mgr.asm · desktop.asm · ux.c

Compositor

Compositing desktop Window manager Wayland clients UEFI framebuffer

Applications → Shortcuts →

src/gui/html.asm · css_engine.c · src/gui/js · web_js.c

Browser engine

HTML + CSS engine Ported JavaScript engine Software WebGL rasterizer

Apps →

src/core/linux_compat.c · syscall.c · elf.c

Linux programs

Chromium Linux build LibreOffice 26.8.0 Java 25 · Temurin OBS Studio

Porting Chromium → LibreOffice → Java runtime → App instances →

ARI

src/core/ari_service.c · ari_agent.c · src/apps/

On-device LLM

XerisGPT 6.6B Quantized AVX2 matmul Chat UI Tool-use agent

Ari Ari models → Training Ari →

Model: XerisGPT 6.6B
Export: int4 · ~4.0 GB weights
KV cache: ~0.8 GB
Tokenizer: 30K BPE

src/net/updater.c

A/B updates

Server: updates.xerisos.com
Manifest: manifest.txt + manifest.sig
Signature: Ed25519 · public key compiled into the OS
Per file: SHA-512
Rollback: tries=0 → back to the last-good slot

Updates Updater design →

Architecture