Skip to main content

Lab Notebook · Bare Metal

Hello Assembly: a 16-bit bootloader, written by hand, to see what sits beneath everything else

In August 2023 we wrote an x86 assembly bootloader and toy kernel by hand — 16-bit real-mode programming, no AI, no abstractions. Purely educational, no product ambition — but it's the direct prerequisite that made a much larger 2024 bet (an AI-written 50,000-line Rust operating system) possible at all.

JR
Jon RossFounder, vocabotics — 15 years building safety-critical systemsLab report · dated 10 August 2023
Verified by a human. Drafted with AI, verified by a human. Jon Ross, 10 Aug 2023
Living document. Reviewed 10 Aug 2023
Entry date
10 August 2023
Category
Hardware
Lead over the world
the discipline, not the lead
Access
🔓 Public
ResearchProven

Before directing an AI through a kernel's boot sequence, we did it ourselves, by hand, in 16-bit real mode — because you can't direct what you've never done.

x86
assembly bootloader + toy kernel
16-bit
real-mode programming

Honest evaluation

Proven

A working, hand-written bootloader and toy kernel, exactly as scoped — no larger claim was made or needed.

What would prove or disprove it further

What would prove or disprove it further: this claim already has an unusually strong falsification test built into the record — the 2024 AI-directed, 50,000-line Rust operating-system project this one was the explicit prerequisite for. That later project failed on a boot-mode mismatch, the precise class of error this project exists to build intuition against. If the hand-written work had genuinely built that intuition, later boot-sequence problems should get diagnosed faster because of it, and that's a checkable claim against the project history.

The evidence — full reasoning behind the verdict

Verdict: proven. The claim was to hand-write a working 16-bit real-mode x86 bootloader and toy kernel, understood line by line, with no product ambition attached — and that's exactly what got built and what the report claims, nothing more.

The evidence is direct: a bootloader that loads a toy kernel from disk and hands it control, written without AI assistance or framework shortcuts. The value of that isn't novelty — nobody claims a new bootloader design here — it's the intuition for the BIOS-to-kernel handoff that only comes from doing it by hand, which is exactly the claim being made.

Runnable proof — see it work

Every abstraction in this whole portfolio — every web app, every agent, every AI tool — sits on top of something that has to boot first. This project went back to that something, by hand.

What it was

A learning project: an x86 assembly bootloader and toy kernel, written in 16-bit real-mode assembly — the mode a PC processor starts in before any operating system, any protected mode, any of the abstractions everything else takes for granted, exists.

What we built

Research

A working bootloader that loads a toy kernel from disk into memory and hands control to it, written and understood line by line in 16-bit real-mode x86 assembly — no AI assistance, no framework, no shortcuts. The point wasn't to build something useful; it was to build something understood, completely, at the level most software never has to think about.

What we learned — including the honest negative(s)

A bootloader is one of the very few pieces of software that has to be correct before an operating system, and therefore before any abstraction built on top of one, exists at all. Writing it by hand — real-mode segmentation, interrupt calls, the handoff from BIOS to bootloader to kernel — builds an intuition for the boot sequence that no amount of reading about it from the outside gives you.

The honest edge is that this was purely educational. There was no product ambition here, and none was claimed. It's a toy kernel, not an operating system — it exercises the boot sequence and nothing beyond it.

Where it went / status

Complete as an educational exercise, and then, twelve months later, directly load-bearing: this hands-on boot-sequence knowledge was the prerequisite that made a far larger 2024 bet possible — directing an AI to write a real 64-bit, 50,000-line Rust operating system from bare metal up. You cannot usefully direct an AI through a kernel's boot handoff if you've never untangled one yourself. That later project's failure, notably, was a boot-mode mismatch — the exact class of problem this project exists to build intuition against.

What is still open — kept visible

The honest edges, next to the wins. This is what turns 🔬 into 🟢 — honestly.

  • Purely educational — no product ambition attached to this project itself.
  • A toy kernel, not a real operating system — it exercises the boot sequence, nothing beyond it.

Where this connects

Sources

  1. vocabotics project audit — Hello Assembly (x86 16-bit bootloader + toy kernel), Aug 2023vocabotics internal project history · as of August 2023

    We use cookies.