Open-source K-12 math knowledge graph for Chinese grades 1–9, aligned to the 2022 curriculum standards, with adaptive prerequisite diagnostics and a question bank.
withmarbleapp/os-taxonomy
An open, structured graph of what primary-school children learn: 1,591 micro-topics linked by prerequisites and aligned to national curriculum standards.
- Stars
- 5,981
- Forks
- 992
- Open issues
- 17
- Last commit
- 18 hours ago
What is it?
This dataset maps what children learn across the primary and elementary years. It breaks curriculum content into fine-grained micro-topics, each with a plain-language description, mastery evidence criteria, a topic type, a subject and domain, and an approximate age range. Topics are connected by 3,225 directed prerequisite edges, so a learner's required foundations can be traced.
Each micro-topic links to the curriculum standards it was derived from, including NGSS, Common Core and the UK National Curriculum. The release covers eight subjects, led by Science and Mathematics. A separate teaching-research file adds teaching approaches, activities and assessment guidance for part of the Science and Mathematics topics.
The data is distributed as plain JSON with checksums and validation scripts, and needs no runtime. Its database is under ODbL 1.0 and its authored text under CC BY-SA 4.0, while upstream curriculum standards keep their own licenses.
Key features
- 01Provides 1,591 micro-topics with descriptions, evidence criteria and age ranges.
- 02Connects topics with 3,225 prerequisite dependencies that include strength and a reason.
- 03Links topics to standards from NGSS, Common Core and the UK National Curriculum.
- 04Includes teaching research for part of the Science and Mathematics topics.
- 05Ships as plain JSON with manifest checksums and validation scripts.
Use cases
- Mapping prerequisite paths for a learning app or adaptive tutoring system.
- Aligning lesson or assessment content to specific national curriculum standards.
- Analyzing how primary-school concepts depend on one another in edtech research.
- Building a curriculum visualization or teacher-facing topic browser.
Quick start
- 1
Clone the repository
- 2
Load the JSON files in data/ directly in your code (no install needed)
- 3
Optionally validate the data structure and checksums
node scripts/validate.mjs
Things to know
- Teaching research covers only Science and Mathematics; 540 topics have no research in this release.
- Teaching activities are research-informed proposals, not empirically validated interventions.
- Source claims were not re-verified for this release.
- Licensing is split: the database is ODbL 1.0 and content is CC BY-SA 4.0, and curriculum standards follow their own upstream licenses.
Topics
FAQ
- What is os-taxonomy?
- An open, structured graph of what primary-school children learn: 1,591 micro-topics linked by prerequisites and aligned to national curriculum standards. This dataset maps what children learn across the primary and elementary years. It breaks curriculum content into fine-grained micro-topics, each with a plain-language description, mastery evidence criteria, a topic type, a subject and domain, and an approximate age range. Topics are connected by 3,225 directed prerequisite edges, so a learner's required foundations can be traced.
- Is os-taxonomy free to use? What license does it have?
- os-taxonomy is open source under the ODbL-1.0 license. Check the license terms before using it in commercial products.
- Is os-taxonomy still maintained?
- Actively maintained. The last commit to os-taxonomy was on Oct 19, 2026.
- What can I use os-taxonomy for?
- Mapping prerequisite paths for a learning app or adaptive tutoring system. Aligning lesson or assessment content to specific national curriculum standards. Analyzing how primary-school concepts depend on one another in edtech research. Building a curriculum visualization or teacher-facing topic browser.
- How do I install os-taxonomy?
- Clone the repository Load the JSON files in data/ directly in your code (no install needed) Optionally validate the data structure and checksums: node scripts/validate.mjs
- Where can I get os-taxonomy?
- The source code and installation instructions are on GitHub: https://github.com/withmarbleapp/os-taxonomy
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A teaching harness for coding agents that plans a course around you, builds lessons, and adapts exercises from your recorded progress.
Indexes a codebase into a knowledge graph of dependencies, call chains and execution flows, and serves it to AI coding agents via MCP tools.
A curated, bilingual-tagged list of online robotics courses, university lectures, books and hands-on resources for self-learners.
A Flutter app for English listening and speaking practice that automates intensive listening, shadowing, blind listening, retelling and spaced review.
Turns unstructured text into an interactive knowledge graph by using an LLM to extract subject-predicate-object triples.