# HSK open data (MIT)

Scripts and datasets used by the [HSK version comparison](https://hidden-dragon.app/hsk-comparison) tool and related blog posts.

## Word-level comparison (3.0 → 3.1)

1. Download into this directory:
   - [`compare-hsk-versions.cjs`](./compare-hsk-versions.cjs)
   - [`complete.json`](./complete.json) — HSK 2.0/3.0 (~9.7 MB)
   - [`hsk3.1-complete.json`](./hsk3.1-complete.json)
2. Run: `node compare-hsk-versions.cjs`
3. Output: [`hsk-3.0-to-3.1-comparison.csv`](./hsk-3.0-to-3.1-comparison.csv)

## Character-level comparison

1. Same inputs as above, plus run [`compare-hsk-characters.cjs`](./compare-hsk-characters.cjs)
2. Output: [`hsk-3.0-to-3.1-char-comparison.json`](./hsk-3.0-to-3.1-char-comparison.json)

## Data sources

- HSK 2.0/3.0: [drkameleon/complete-hsk-vocabulary](https://github.com/drkameleon/complete-hsk-vocabulary) (MIT)
- HSK 3.1: [becky82/mteh HSK3.1](https://github.com/becky82/mteh/tree/main/sources/HSK3.1)

## License

Comparison scripts in this folder are MIT. See file headers for upstream dataset terms.