What is SlopOS?
SlopOS is a from-scratch x86_64 operating system written entirely by AI. No human wrote a single line of kernel code. Every syscall, every memory allocator, every driver - generated through AI pair programming with mass token consumption. The result? An OS that boots. Sometimes. When the Wheel of Fate allows it.
Why “Slop”?
In AI terminology, “slop” refers to low-quality AI-generated content. SlopOS embraces this label - it’s an operating system built on the premise that AI can write kernel code, bugs and all. Every crash is a feature. Every panic is expected. The sloppiness is the point.The Technical Reality
Despite its name, SlopOS implements real operating system concepts:| Component | Implementation |
|---|---|
| Memory | Buddy allocator with demand paging |
| Processes | Ring 0/3 isolation with TSS, preemptive scheduling |
| Syscalls | SYSCALL/SYSRET fast path |
| Interrupts | IOAPIC + LAPIC (no legacy PIC) |
| Storage | ext2 filesystem on VirtIO block devices |
| Input | PS/2 keyboard and mouse drivers |
| Graphics | Framebuffer with compositor |
The Wheel of Fate
SlopOS introduces a unique boot mechanism: the Wheel of Fate. Every boot is a gamble.- Win the spin → Enter the shell
- Lose the spin → Kernel panic, try again
Architecture Overview
Kernel Subsystems
Kernel Subsystems
- boot/ - GDT, IDT, TSS, early init, SYSCALL MSRs
- mm/ - Physical frame allocator, virtual memory, ELF loader
- core/ - Scheduler, syscall handlers, task management
- drivers/ - PIT, PS/2, IOAPIC, VirtIO, PCI enumeration
- video/ - Framebuffer, graphics primitives, roulette wheel renderer
- fs/ - ext2 filesystem implementation
Userland Applications
Userland Applications
- Shell - Command-line interface
- Compositor - Window management system
- Roulette - The Wheel of Fate UI
- File Manager - ext2 file browser
Build System
Build System
justtask runner- Rust nightly with
#![no_std] - Custom linker script (
link.ld) - Limine bootloader
- QEMU for testing (q35 machine, requires IOAPIC)
The Sacred Lore
SlopOS development is documented as an epic tale in thelore/ directory. Three kernel wizards - Fabrice, Leon, and Luis - shipwrecked on the island of Sloptopia, armed with nothing but Rust and unlimited AI tokens.
The chronicles document every triumph and failure, every boot and panic, in mythical prose. Reading the lore is recommended before contributing.
Read the Chronicles
GENESIS.md → THE_SLOPOCALYPSE.md → THE_COOKED.md
Contributing
SlopOS welcomes contributions - both human and AI-assisted. Review the AGENTS.md for guidelines on:- Coding style and naming conventions
- Commit message format
- W/L Currency System integration
- Lore documentation requirements
All changes must respect the sacred lore. The Wheel of Fate governs all.
