# yhzhang0128/egos-2000

Envision a future where everyone can read all the code of an educational operating system.

Repository: https://github.com/yhzhang0128/egos-2000
Canonical: https://ross.abutalabs.com/products/egos-2000
Homepage: https://egos.fun/
Language: C
License: NOASSERTION
License Family: other
Topics: education, operating-system
Last push: 2026-08-16T12:54:44+00:00

## Health v2 (maintenance only)
Score: 86/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 62, longevity 100
- inputs: {"age_days": 1598, "days_push": 17, "days_rel": 42, "gap_med": 254.0, "n_releases_24m": 3}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3575, forks 305 (observed 2026-08-28T04:08:10.756208+00:00)

## What it is
egos-2000 is a teaching operating system implemented in exactly 2000 lines of C and assembly that runs on QEMU and RISC-V boards. It is designed so students can read all of its code, and is accompanied by the EGOS book with nine course projects.

## Use cases
- learn how an operating system works by reading all its code
- teach an undergraduate OS course with hands-on projects
- study RISC-V privileged architecture and kernel internals
- run a minimal OS on QEMU for experimentation
- implement OS course projects like file systems and system calls

## When to choose
- you want a tiny, fully readable OS codebase for education
- you are teaching or taking an operating systems course on RISC-V
- you prefer minimal code over production complexity

## When to avoid
- you need a production-grade or general-purpose operating system
- you require broad hardware support beyond RISC-V and QEMU
- you need features like SMP, networking stacks, or security hardening

## Facets
- artifact type: learning-resource
- maturity: active
- function: embedded
- domain: operating-systems, education, embedded-systems
- platform: windows, cpp, embedded
- tags: teaching-operating-system, risc-v, qemu, course-projects, minimal-os, operating-system, education, linux, macos

## Member repositories
- yhzhang0128/egos-2000 (main) score 86

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:10.756208+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:34:03.379382+00:00, confidence not recorded.
  - readme: https://github.com/yhzhang0128/egos-2000 (fetched 2026-08-28T04:08:10.756208+00:00, sha 0b1dd6b2d80e)
  - homepage: https://egos.fun/ (fetched 2026-08-29T09:27:35.424112+00:00, sha a9b411196dc9)
- Data as of 2026-08-30T08:39:29.467469+00:00.