Show HN: I wrote an OS in 1000 lines of Zig

https://github.com/botirk38/OS-1000-lines-zig

151•botirk•4mo ago

Comments

botirk•4mo ago

I wanted to understand what the bare minimum of an operating system looks like.

So I built one in Zig, keeping the whole thing under 1000 lines of code.

It can: → Boot from GRUB → Manage memory → Schedule simple tasks → Output text to VGA

The point was not to make it feature-rich, but to show how much is possible with just a few hundred lines if you strip everything down to the essentials.

noone_youknow•4mo ago

Nice work! Looks like most of the basics are covered, and meanwhile in my current kernel the RISC-V entrypoint is >700 lines (of C) just to get to the arch-independent entrypoint!

I was just looking around for your input/output code, I don’t know zig but I expected to find putChar in kernel.zig based on the import in common.zig, but I don’t see it, should I be looking somewhere else? I didn’t see any simple command line processing either as mentioned in the README?

Mostly just looking around since your README mentioned VGA (and you seem to have a BIOS boot) which struck me as interesting on a RISC-V project, I was curious if you were actually using the SBI routines or had actually mapped in a VGA text mode buffer?

WD-42•4mo ago

There is a todo in the putchar stub. Looks like it’s not implemented yet.

I have it implemented here in my own roughly 1k line zig kernel: https://github.com/Fingel/aeros-v/blob/ddc6842291e9cf4876729...

noone_youknow•4mo ago

Thanks! I see that you’re using the SBI routines, which is what I was expecting here but couldn’t find - the reference to “output text to VGA” in the post made me curious.

I did see the putchar stub in the user.zig but, lacking understanding of zig, wasn’t sure how that could work given common.zig is looking for putChar in kernel.zig as far as I could tell.

I just jumped through a couple of hoops to get zig 0.13 installed and see an error about “root struct of file ‘kernel’ had no member named ‘putchar’” so I guess maybe it’s not implemented here at all.

WD-42•4mo ago

I don’t know what output to the VGA means from the OP. I suspect that entire project was vibe coded including the readme. It’s a common first step when writing an OS for x86 but for riscv you don’t use vga to get text output, you go through the UART.

Are you saying you had trouble getting putchar working in my implementation? As far as I know common.console is fully implemented and working. Let me know if something is wrong.

noone_youknow•4mo ago

Sorry for the confusion, I was referring to the putchar not being implemented in OPs code, I got yours working right away (nice work btw).

What you mention about VGA being common on x86 was what got me curious, since it’s not a thing on riscv. In my own OS project I’m using a framebuffer to show a graphical terminal on both x86 and riscv64 so I wondered if OP was doing similar or was really using SBI output.

cyberclimb•4mo ago

Hi botirk, really interesting project!

If I build the project what is the output format and how could configure things to boot it?

I know how to this with IMG and ISO files of course but not sure what to do with the build output if it's an executable?

Also any insights into whether this would also boot on an ARM machine? Thanks!

coffeeri•4mo ago

Check the build.zig file. It defines the arguments for QEMU to run the OS.

You should be able to run zig build run.

hdjxjdjdkshsb•4mo ago

Curious: is it 1k lines of zig total with no libraries or 1k lines of zig with libraries?

mcny•4mo ago

I don't know zig but the only import I see here is std so my guess is there are no libraries here?

botirk•4mo ago

no libs at all, only std where appropriate, and there is no hidden sys calls

tjpnz•4mo ago

Nice project! I'm more accustomed to building and running these using QEMU/VirtualBox (which I understand you can do with here). But what's going on when I build and execute it under the host OS? Is it also running in userspace?

mmaunder•4mo ago

“Interact with the command-line interface to execute commands and view output”

A command line interface has not been implemented. It just prints a bootup message.

“Some basic examples of usage include: Running a simple "Hello World" program Viewing system information such as memory usage and process list”

None of this has been implemented.

Was this vibe coded? Asking because the README disconnect with the code is weird.

Seems to be written in Zig 0.13. That’s about a year old. 0.15 has breaking changes so it’ll need to be ported if you’re going to do anything with this.

reactordev•4mo ago

Bingo, I was about to post the same but you hit all the things I was going to say.

This is completely fake and only prints stuff out like it works.

ko_pivot•4mo ago

> The project includes automated tests and validation scripts to ensure its correctness and stability

LLMs love writing this type of stuff.

never_inline•4mo ago

Btw, the unicode arrows in Gp comment are dead giveaway of LLM use.

freetonik•4mo ago

God damn it, I love using these arrows and have a special keyboard layout that allows me to quickly add them, and now I will subconsciously hesitate.

nvlled•4mo ago

I die inside whenever I see something like this. Not even a word that this is a reference to the "Operating System in 1,000 Lines" which someone else linked in this thread. The worst part is that OP probably learned nothing about operating systems from this project.

botirk•4mo ago

its been ported, currently basic paging, scheduling is implemented, but still need to implement sys call interface

mtlynch•4mo ago

Cool projects!

A few suggestions:

- You're committing .zig-cache to git, but that's build output, so it shouldn't be under version control. You should add it to .gitignore (you already have zig-cache without leading dot).

- Your README.md refers to a CONTRIBUTING.md that doesn't exist

- It's helpful to say exactly which Zig compiler you need. It currently says "0.10.0 or later" but 0.10.0 is almost three years old now.[0] Most 0.10.0 code does not compile in 0.15.1.

[0] https://ziglang.org/download/#release-0.10.0

botirk•4mo ago

yes good point, README was AI generate not going to lie, missed those details its updated now to work with 0.15!

wsve•4mo ago

I was hoping to get some commentary about the project and what lessons you learned from it. You wrote an OS in 1000 lines of Zig, but... So what? What should I take away from this? Are you posting this to encourage people to use the OS, or learn from the project? How was Zig helpful or a hindrance for this? Why limit to 1000 lines? Why did you post this?

gjm11•4mo ago

You might want to look at the author's comment here (https://news.ycombinator.com/item?id=45290591) posted at about the same time as the link itself, which largely answers these questions.

botirk•4mo ago

this is not usable at all, its just to show people that OSes are not mysterious things, at a bare bones level quite simple

sofia44•4mo ago

Very cool! Mad props friend

botirk•4mo ago

thanks!

ants_everywhere•4mo ago

Sweet!

Folks interested in this may also like "Operating System in 1,000 Lines" https://operating-system-in-1000-lines.vercel.app/en/

and the implementation in C https://github.com/nuta/operating-system-in-1000-lines

botirk•4mo ago

yes exactly, its based off that!

anta40•4mo ago

How to build the OS? I'm on macOS with zig 0.15.1 installed.

`zig build` gave me this:

/Users/anta40/Lab/OSDev/OS-1000-lines-zig/build.zig.zon:9:13: error: expected enum literal .name = "zoros",

s-lambert•4mo ago

The project was made with an older version of Zig, which used strings as keys in zig.build.zon before but then it was changed to use enum literals in 0.14.0 IIRC.

botirk•4mo ago

yea exactly!

valleyer•4mo ago

Bizarre that the README.md does not specify that this is for RISC-V.

I also went to look to see where "console output" was implemented, and ... it looks like it's just not? ConsoleWriter.write() calls kernel.putChar, which does not exist...

a96•4mo ago

I also tried to find what this is supposed to run on. Some of it looks like intel crap and most looks like it's just an application. Looking at the comments, this seems to be AI slop that doesn't actually run on anything or do anything.

botirk•4mo ago

were you trying to build with 0.15, it was broken till recently, I like to preface this is not a feature ready OS, its just a learning experiment!

Start all of your commands with a comma (2009)

Hoot: Scheme on WebAssembly

OpenCiv3: Open-source, cross-platform reimagining of Civilization III

The Waymo World Model

Vocal Guide – belt sing without killing yourself

Reinforcement Learning from Human Feedback

Making geo joins faster with H3 indexes

Where did all the starships go?

Unseen Footage of Atari Battlezone Arcade Cabinet Production

Jeffrey Snover: "Welcome to the Room"

ga68, the GNU Algol 68 Compiler – FOSDEM 2026 [video]

What Is Ruliology?

Show HN: Look Ma, No Linux: Shell, App Installer, Vi, Cc on ESP32-S3 / BreezyBox

Monty: A minimal, secure Python interpreter written in Rust for use by AI

Show HN: I spent 4 years building a UI design tool with only the features I use

Hackers (1995) Animated Experience

Sheldon Brown's Bicycle Technical Info

Show HN: If you lose your memory, how to regain access to your computer?

Microsoft open-sources LiteBox, a security-focused library OS

An Update on Heroku

Cross-Region MSK Replication: K2K vs. MirrorMaker2

PC Floppy Copy Protection: Vault Prolok

Was Benoit Mandelbrot a hedgehog or a fox?

Dark Alley Mathematics

The AI boom is causing shortages everywhere else

How to effectively write quality code with AI

Delimited Continuations vs. Lwt for Threads

I now assume that all ads on Apple news are scams

Introducing the Developer Knowledge API and MCP Server

Understanding Neural Network, Visually

Start all of your commands with a comma (2009)

Hoot: Scheme on WebAssembly

OpenCiv3: Open-source, cross-platform reimagining of Civilization III

The Waymo World Model

Vocal Guide – belt sing without killing yourself

Reinforcement Learning from Human Feedback

Making geo joins faster with H3 indexes

Where did all the starships go?

Unseen Footage of Atari Battlezone Arcade Cabinet Production

Jeffrey Snover: "Welcome to the Room"

ga68, the GNU Algol 68 Compiler – FOSDEM 2026 [video]

What Is Ruliology?

Show HN: Look Ma, No Linux: Shell, App Installer, Vi, Cc on ESP32-S3 / BreezyBox

Monty: A minimal, secure Python interpreter written in Rust for use by AI

Show HN: I spent 4 years building a UI design tool with only the features I use

Hackers (1995) Animated Experience

Sheldon Brown's Bicycle Technical Info

Show HN: If you lose your memory, how to regain access to your computer?

Microsoft open-sources LiteBox, a security-focused library OS

An Update on Heroku

Cross-Region MSK Replication: K2K vs. MirrorMaker2

PC Floppy Copy Protection: Vault Prolok

Was Benoit Mandelbrot a hedgehog or a fox?

Dark Alley Mathematics

The AI boom is causing shortages everywhere else

How to effectively write quality code with AI

Delimited Continuations vs. Lwt for Threads

I now assume that all ads on Apple news are scams

Introducing the Developer Knowledge API and MCP Server

Understanding Neural Network, Visually

Show HN: I wrote an OS in 1000 lines of Zig

Comments