Getting Started

Build from Source

VernisOS compiles everything from source: the Assembly bootloader, C kernel, Rust AI engine, and user-space tools.

Clone the Repository

bash

git clone https://github.com/Pakawat-Tan/VernisOS.git
cd VernisOS

make

Build the full OS image (auto-detects architecture)

make run64

Build and run in QEMU (x86_64)

make run32

Build and run in QEMU (x86)

make clean

Remove all build artifacts

make prerequisites

Check that all required tools are installed

The Makefile orchestrates a multi-stage build pipeline:

Stage 1NASM assembles the MBR bootloader (boot.asm → boot.bin)

Stage 2NASM assembles the kernel loader (loader.asm → loader.bin)

Stage 3GCC compiles kernel C code, Rust builds the AI engine (no_std)

Stage 4LD links everything into a single disk image (~4MB)