explaingit

nulllabtests/uniqos

Analysis updated 2026-05-18

2CAudience · developerComplexity · 5/5Setup · hard

TLDR

A from-scratch operating system with its own kernel, networking, GUI, and web browser, built largely with AI coding assistance.

Mindmap

mindmap
  root((UniqOS))
    What it does
      Custom x86_64 kernel
      Full TCP/IP networking
      GUI desktop and browser
    Tech stack
      C
      Assembly
      GRUB Multiboot2
    Use cases
      Learn OS internals
      Explore AI-assisted systems coding
      Run apps in a custom desktop
    Audience
      OS hobbyists
      Low-level systems learners
    Limitations
      No persistent storage
      No HTTPS or JavaScript
      Cooperative scheduler only

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Explore how a bare-metal operating system kernel is built from scratch.

USE CASE 2

Study a full custom TCP/IP network stack implementation.

USE CASE 3

Run a graphical desktop with a terminal, editor, and file manager in a VM.

USE CASE 4

See how far AI-assisted coding can go on a complex low-level systems project.

What is it built with?

CAssemblyGRUBTCP/IP

How does it compare?

nulllabtests/uniqoscode-my-spec/ear_witnessdakshlohchab/risc_v_32i
Stars222
LanguageCCC
Setup difficultyhardhardhard
Complexity5/54/54/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires a specific clang cross-compiler toolchain plus VirtualBox or QEMU to run the built ISO.

In plain English

UniqOS is a computer operating system built completely from scratch, not based on Linux or any existing system. It was written mostly with help from AI language models, and the author treats the project as a personal demonstration of how far AI assisted coding has come. The system boots on real x86 64 bit hardware or in a virtual machine, and it includes its own kernel, its own network stack, its own graphical desktop, and even its own simple web browser, all written from the ground up. Underneath, the operating system handles the basics an OS needs: managing memory, handling hardware interrupts, and switching between running tasks. It has drivers for a graphics display, keyboard, mouse, and a virtual network card. On top of that sits a full TCP and IP networking stack, meaning it can resolve internet addresses, send and receive real network packets, and make basic web requests using HTTP. The graphical side includes a window manager with movable windows, a taskbar style panel at the bottom of the screen, and a handful of built in applications: a terminal, a text editor, a file manager, a simple system monitor, and the web browser itself, which can fetch a page and display its text with basic styling. The browser cannot yet handle secure HTTPS connections, JavaScript, or modern CSS. The README is upfront about current limitations. There is no permanent storage yet, since the file system only exists in memory and disappears on reboot. The task scheduler is cooperative rather than fully preemptive, and there is no automated testing, so quality is checked manually. Building it requires a specific compiler toolchain and either VirtualBox or QEMU to run it. This project is aimed at people curious about operating system internals or interested in how AI tools can help build complex, low level software.

Copy-paste prompts

Prompt 1
Walk me through building UniqOS and running it in VirtualBox or QEMU.
Prompt 2
Explain how the custom TCP/IP network stack in this OS works.
Prompt 3
Help me understand the memory manager and cooperative scheduler design.
Prompt 4
Show me what the current limitations mean for using the built-in browser.

Frequently asked questions

What is uniqos?

A from-scratch operating system with its own kernel, networking, GUI, and web browser, built largely with AI coding assistance.

What language is uniqos written in?

Mainly C. The stack also includes C, Assembly, GRUB.

How hard is uniqos to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is uniqos for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.