whatisgithub

What is graceos?

aurielsolaris/graceos — explained in plain English

Analysis updated 2026-08-08 · repo last pushed 2026-04-17

2CAudience · developerComplexity · 5/5MaintainedSetup · hard

In one sentence

A complete from-scratch hobby operating system written in C and assembly, featuring a custom kernel, shell, text editor, networking, audio playback, a built-in programming language, and an in-kernel LLM engine.

Mindmap

mindmap
  root((repo))
    What it does
      Bootable OS from scratch
      Shell and text editor
      Snake game and audio
      In-kernel LLM engine
    Tech stack
      C language
      Assembly
      ARM64 port
    Use cases
      Learn OS internals
      Study kernel scheduling
      Run simple programs
    Audience
      OS enthusiasts
      Low-level programmers
      Students

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

Boot the OS in an emulator and explore the shell, text editor, and Snake game.

USE CASE 2

Write and run simple programs using the built-in ChibiVM programming language.

USE CASE 3

Study how the Lumina Kernel manages memory, task scheduling, and file systems.

USE CASE 4

Experiment with the in-kernel LLM engine that runs models without external software.

What is it built with?

CAssemblyARM64

How does it compare?

aurielsolaris/graceosalexsjones/whisper-clialisharafiiii/sauron-eye
Stars222
LanguageCCC
Last pushed2026-04-172015-09-12
MaintenanceMaintainedDormant
Setup difficultyhardmoderatehard
Complexity5/53/55/5
Audiencedeveloperdeveloperdeveloper

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 cross-compilation toolchain and an emulator like QEMU to boot, building an OS from source involves non-trivial system configuration.

The explanation does not mention a license, so the usage terms for this project are unknown.

So what is it?

GraceOS is a complete, from-scratch operating system built as a personal hobby project. Instead of running on top of Windows, macOS, or Linux, it is its own foundational software that talks directly to computer hardware. It gives you a bootable system complete with a command-line shell, a text editor, networking tools, a Snake game, and even the ability to play audio files. At a high level, an operating system's job is to manage the computer's memory, juggle multiple running programs at once, and provide basic services like reading files or drawing text to the screen. GraceOS handles all of this with a custom core called the Lumina Kernel. It includes its own in-memory file system, a security manager to control user permissions, and a basic networking stack so it can understand internet protocols like HTTP. It even has a built-in mini programming language and runtime, called ChibiVM, so you can write and run simple programs directly inside the system. This project is primarily for operating system enthusiasts, low-level programmers, and students who want to study how a computer works from the ground up. It is not something a typical user would install on their daily laptop. However, it is a fascinating sandbox for learning. For example, a developer could boot it up in an emulator, type commands into the shell to create files, use the text editor, compile a small script with ChibiVM, and watch how the kernel schedules different tasks all at once. The most notable thing about the project is its sheer ambition and unusual feature set for a hobby OS. Beyond the standard features, it includes an in-kernel engine designed to run large language models (LLMs) directly, without relying on external software. It is also actively being ported to work on ARM64 devices like the Raspberry Pi 3B, though the README notes that port is currently a work in progress. Built entirely in C and assembly language across roughly 30,000 lines of code, it is a remarkably complete look at what it takes to build a PC environment from nothing.

Copy-paste prompts

Prompt 1
I want to boot GraceOS in QEMU. Walk me through compiling the source and starting it in an emulator step by step.
Prompt 2
Help me write a simple program in ChibiVM, the built-in language inside GraceOS, and explain how to run it from the shell.
Prompt 3
Explain how the Lumina Kernel in GraceOS handles task scheduling and memory management so I can follow the source code.
Prompt 4
I want to understand how the in-kernel LLM engine in GraceOS works. Help me find and read the relevant source files.
Prompt 5
GraceOS is being ported to ARM64 for the Raspberry Pi 3B. Help me figure out what parts of the build process differ for that target.

Frequently asked questions

What is graceos?

A complete from-scratch hobby operating system written in C and assembly, featuring a custom kernel, shell, text editor, networking, audio playback, a built-in programming language, and an in-kernel LLM engine.

What language is graceos written in?

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

Is graceos actively maintained?

Maintained — commit in last 6 months (last push 2026-04-17).

What license does graceos use?

The explanation does not mention a license, so the usage terms for this project are unknown.

How hard is graceos to set up?

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

Who is graceos for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.