README.md
March 23, 2026 ยท View on GitHub
swerve
A suckless-inspired Unix-like monolithic kernel for i386 machines.
Note
This is a work in progress. Please don't run this on real hardware.
Prerequisites for building
- GNU Binutils cross-compiled for swerve
- GCC cross-compiled for swerve
- GNU Make
- A POSIX shell (
dash,bash, ...)
To cross-compile GCC and GNU Binutils for swerve, follow this guide.
Prerequisites for making a GRUB image
- fdisk (from util-linux)
- GNU GRUB
Building
- Edit
config.mkto your liking make
Run in QEMU
- Run
make run-qemu
Build GRUB image
- Run
make grub-image
License
All of the source code for the kernel and libc are licensed under the GNU GPL v3 (see [LICENSE.gpl]), unless otherwise noted. All documentation (in the doc directory) is licensed under the GNU FDL v1.3 (see [LICENSE.gfdl]), unless otherwise noted. All videos, images, and audio are licensed under the Creative Commons Attribution Share-Alike 3.0 Unported License (http://creativecommons.org/licenses/by-sa/3.0/), unless otherwise noted.