# rCore-Tutorial-v3

Let's write an OS which can run on RISC-V in Rust from scratch!

Repository: https://github.com/rcore-os/rCore-Tutorial-v3
Canonical: https://ross.abutalabs.com/products/rcore-tutorial-v3
Homepage: https://rcore-os.cn/rCore-Tutorial-Book-v3/
Language: Rust
License: GPL-3.0
License Family: copyleft
Topics: rust, risc-v, rcore, operating-system, k210
Last push: 2026-07-03T14:52:25+00:00
Link (homepage): https://rcore-os.cn/rCore-Tutorial-Book-v3/
Link (site_page): https://rcore-os.cn/rCore-Tutorial-Book-v3/chapter0/4os-features.html

## Health v2 (maintenance only)
Score: 63/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 90, release rhythm 8, longevity 100
- inputs: {"age_days": 2134, "days_push": 61, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2100, forks 556 (observed 2026-08-28T04:06:13.574888+00:00)

## What it is
rCore-Tutorial-v3 is a step-by-step tutorial project that teaches how to write a Unix-like operating system for RISC-V from scratch in Rust, targeting QEMU and Kendryte K210 boards. It includes a small (~4K+ LoC) teaching kernel with processes, threads, virtual memory, a file system, and a shell, plus detailed (Chinese-language) book documentation.

## Use cases
- learn how to write an operating system from scratch
- learn OS development in Rust
- study RISC-V kernel internals
- teach an undergraduate operating systems course
- understand virtual memory and SV39 page tables
- learn how syscalls, processes, and scheduling work
- run a toy OS on QEMU or a K210 board

## When to choose
- you want a hands-on, incremental OS-in-Rust tutorial for RISC-V
- you are a beginner without prior OS or assembly background
- you need a compact teaching kernel with accompanying book chapters and exercises

## When to avoid
- you need a production-grade OS kernel
- you require English documentation (the book is currently Chinese-only)
- you target architectures other than RISC-V

## Facets
- artifact type: learning-resource
- maturity: active
- function: programming-language, developer-tools
- domain: operating-systems, education, tutorials
- platform: rust, cross-platform
- tags: risc-v, operating-system, rust, osdev, qemu, k210, teaching-os, unix-like, linux

## Member repositories
- rcore-os/rCore-Tutorial-v3 (main) score 63
- rcore-os/rCore-Tutorial-Book-v3 (docs) score 92

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:13.574888+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-30T02:54:19.651584+00:00, confidence not recorded.
  - readme: https://github.com/rcore-os/rCore-Tutorial-v3 (fetched 2026-08-28T04:06:13.574888+00:00, sha 7ce1810b40e0)
  - homepage: https://rcore-os.cn/rCore-Tutorial-Book-v3/ (fetched 2026-08-29T10:34:36.153718+00:00, sha b705606aa5de)
  - site_page: https://rcore-os.cn/rCore-Tutorial-Book-v3/chapter0/4os-features.html (fetched 2026-08-29T10:34:36.163120+00:00, sha 47a422512745)
- Data as of 2026-08-30T08:39:29.467469+00:00.