Skip to main content

ukvocab

The published Ukrainian vocabulary data from jakelawrence.xyz/research/ukrainian-frequency, installable and offline: the top-12,000 lemma frequency list over UberText 2.0, the validated PULS CEFR overlay (A1 to C1), the Borodin A1 and A2 lexical minimums, the crosswalk between the minimums and the profile, the B1 enrichment tables (aspect relations, case government, collocations), and a per-lemma word-stress column.

import ukvocab
ukvocab.lookup("п'ять")["level"]                       # 'A1', with rank, source and enrichment beside it
ukvocab.lookup("орган")["stress"]                       # {'stress': 'о́рган', 'variants': ['о́рган', 'орга́н'], 'status': 'homograph', ...}
ukvocab.coverage(["в", "школа", "йти"], "A2")["coverage"]  # share of tokens a validated-A2 learner knows

What you get

function returns
lookup(lemma, pos=None) one lemma: level, level_source, rank, the frequency figures, the stress (primary stressed form, accepted variants, resolution status and note), every other reading of the spelling, minimum membership, the crosswalk class, and the B1 enrichment (aspect partners, government, collocations); None when no table knows the string
levels(lemmas) batch: input string to {level, level_source, rank, pos, source}
coverage(lemmas, known_set) token coverage of a lemmatized text against a known set: a level ("A2" means every validated lemma at or below A2), "borodin-a1" / "borodin-a2", an int N (top N of the list), or your own set of lemmas; reports the unknowns by frequency
sources() version, snapshot date, license, attribution, citation and SHA-256 per dataset, the combined license and why, and what is deliberately not shipped

Every return value carries the dataset, version and snapshot it came from. Data is Parquet, loaded lazily on first use, never on import. The only dependency is pyarrow.

Two things the package does not do, on purpose. It does not lemmatize: pass lemmas in the UberText / VESUM convention (infinitive for verbs, nominative singular for nouns); the site's POST /api/lemmatize is the hosted lemmatizer matched to this list. And it ships no predicted CEFR levels: only the profile's validated levels are here, and a lemma the profile does not cover gets level: None rather than a guess.

Provenance and honesty

The data tier is generated from the site's published download files by scripts/ukrainian-frequency/build-package.py in the source repository and is never edited by hand; the tests assert that every table's row count and hash match the published file exactly. sources() is the manifest that build wrote. The PULS overlay is a dated snapshot (2026-07-23) of a profile that is still being extended, redistributed with its authors' permission. The join onto the frequency list is part-of-speech aware; ten declared cross-tag rules recover the words the two tag conventions merely label differently, and each row's join field says how it matched, so the strict join is one filter away.

License

The combined package is CC-BY-NC-SA 4.0, because the PULS levels are NonCommercial and share-alike at the authors' decision (2026-09-24) and they run through most tables. The frequency list and the two Borodin minimums are CC-BY 4.0 on their own, and the government, collocation and stress tables CC-BY-SA 4.0; drop the PULS level columns and NonCommercial does not apply. LICENSES.md has the per-dataset terms and every attribution.

Citation

Lawrence, J. (2026). ukvocab: the Ukrainian Frequency datasets (top-12,000 lemma
list, validated PULS CEFR overlay, Borodin A1/A2 minimums, crosswalk, B1
enrichment tables, word stress), version 0.4.1. jakelawrence.xyz/research/ukrainian-frequency.

Upstream: Chaplynskyi, D. (2023). Introducing UberText 2.0: A Corpus of Modern
Ukrainian at Scale. Proc. 2nd UNLP, ACL. | Synchak, O., Starko, V., Burak, M.,
Svystun, M. (2025). Corpus-Based Vocabulary Profiling for Ukrainian: From
Lexical Analysis to CEFR. eLex 2025; PULS, puls.peremova.org. | Borodin, K. and
Turkevych, O. 1000 i 1 slovo, A1. https://doi.org/10.18452/28236 | Borodin, K.
and Lazarenko, O. (2026). 1000 i 1 slovo, A2. https://doi.org/10.11584/opus4-1448
| Syvokon, O. and Chaplynskyi, D. (lang-uk). ukrainian-word-stress, MIT.
https://github.com/lang-uk/ukrainian-word-stress

Archived, DOI-minted copies of each dataset are listed in sources() under conceptDoi once they exist; cite the concept DOI for the dataset you used.

Metadata

Release files for ukvocab 0.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ukvocab 0.4.1
File Size Uploaded Provenance Actions
ukvocab-0.4.1.tar.gz 912.8 kB With provenance Details for ukvocab-0.4.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ukvocab 0.4.1
File Interpreter ABI Platform Actions
ukvocab-0.4.1-py3-none-any.whl Python 3 none any Details for ukvocab-0.4.1-py3-none-any.whl

Total release size: 1.8 MB

Release files / ukvocab-0.4.1.tar.gz

Download URL ukvocab-0.4.1.tar.gz
Size 912.8 kB
Tags Source
SHA-256 checksum
How to use checksums
9de64abb964da98f2670a1ebe2a1a7eabb53c76b549b57621c7c92a6ee63f852
BLAKE2b-256 checksum
How to use checksums
9d7f6abaeb7ed4a090ab9b3bc58add979d69662a6064dca5745a69ca15495576
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / ukvocab-0.4.1-py3-none-any.whl

Download URL ukvocab-0.4.1-py3-none-any.whl
Size 907.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5dfe51e2d970bedbc14f994c41544bb0a3c4aaa32f9a30ca17cafe1cf186e17c
BLAKE2b-256 checksum
How to use checksums
95d108a57095ee1953a588e0f6c67dd2c602fe3ec6d7651190152b2ca8ef2f66
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Security for ukvocab 0.4.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for ukvocab-0.4.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page