modern-greek-backend-eee
Modern Greek (el) morphology backend for the
Ελληνικά Εκπαιδευτικά Εργαλεία (EEE) — Greek Language Educational Tools.
Implements ModernGreekBackend, satisfying the MorphologyBackend protocol
defined in the eee package.
🔓 Open source:
- prod — https://github.com/EEE-project/modern-greek-backend-eee
- prod mirror — https://gitlab.com/EEE-project/modern-greek-backend-eee
- dev — https://codeberg.org/EEE-project/modern-greek-backend-eee
💬 Community: https://telegram.me/eee_greek
Wraps modern-greek-inflexion-eee, a fork of Picus Zeus's modern-greek-inflexion. Deployed at ellinika.com.pl. License: MIT.
Per the upstream README, the library "works thanks to a big corpus on which it tests forms it tries to create." Word lists from Wikileksiko are used as lexical reference data for accentuation and declension details (genitive existence, vocative endings in -ος nouns).
Period: Standard Modern Greek (Demotic, post-1976). Primarily targets Νέα Ελληνική Κοινή after the 1976 language reform that established Demotic as the official standard. Some archaic forms are explicitly suppressed.
Installation
pip install modern-greek-backend-eee
Development version (latest, from Codeberg):
pip install "modern-greek-backend-eee @ git+https://codeberg.org/EEE-project/modern-greek-backend-eee.git"
Usage
from modern_greek_backend_eee import ModernGreekBackend
backend = ModernGreekBackend()
# Verb — present active 1sg
forms = backend.inflect("γράφω", {
"Tense": "Pres", "Person": "1", "Number": "Sing"
}, "verb")
# {"γράφω"}
# Noun — genitive plural
forms = backend.inflect("γυναίκα", {
"Case": "Gen", "Number": "Plur"
}, "noun")
# {"γυναικών"}
# Pronoun — strong vs. weak/clitic (αυτός "he/it")
backend.inflect("αυτός", {"Case": "Acc", "Number": "Sing", "Gender": "Masc"}, "pronoun")
# {"αυτόν", "αυτό"}
backend.inflect("αυτός", {"Case": "Acc", "Number": "Sing", "Gender": "Masc", "Clitic": "Yes"}, "pronoun")
# {"τον"}
# Article
backend.inflect("ο", {"Case": "Gen", "Number": "Sing", "Gender": "Masc"}, "article")
# {"του"}
# Numeral — ordinal (adjective-shaped) vs. quantity noun (noun-shaped)
backend.inflect("τρίτος", {"Case": "Nom", "Number": "Plur", "Gender": "Fem"}, "numeral")
# {"τρίτες"}
backend.inflect("χιλιάδα", {"Case": "Gen", "Number": "Sing"}, "numeral")
# {"χιλιάδας"}
Feature keys follow Universal Dependencies FEATS.
Auto-registered via two entry point groups on install:
eee_project.backends.v1→ keyel(default backend for Modern Greek)eee_project.named_backends.v1→ keymodern-greek(selectable viabackend="modern-greek")
This means eee.inflect(..., language="el") and eee.inflect(..., backend="modern-greek")
both work without explicit registration.
Coverage
Verb/noun/adjective/adverb: rule-based algorithm, accepts any lemma as input,
applies Modern Greek morphological rules, and validates candidate forms
against the corpus. Returns an empty set only when the lemma is
unrecognizable. There is no finite lexicon for these four, so
list_lemmas() returns [] for them.
Pronoun/article/numeral are different: genuinely closed word classes, backed
by modern_greek_inflexion_eee's own explicit lemma lists (not a rule
engine), so list_lemmas() returns the real set for these three.
| POS | Support |
|---|---|
| Verb | Full paradigm (all persons, tenses, moods) |
| Noun | All cases and numbers |
| Adjective | All genders, cases, numbers |
| Adverb | Positive / comparative |
| Pronoun | Case+Number+Gender for most; Case+Number only for εγώ/εσύ (no Gender axis); invariant for adverbial ones (πού/πότε-type) — see _mg_features.mg_pron_path()'s docstring for the three shapes. Clitic=Yes selects weak/enclitic forms |
| Article | ο (definite) / ένας (indefinite) — Case+Number+Gender |
| Numeral | Ordinals/multiplicatives (adjective-shaped) and quantity nouns like χιλιάδα (noun-shaped) — list_lemmas() covers these two closed lists; basic cardinal numbers (one/two/three...) still inflect() correctly by lemma but aren't enumerated (see list_lemmas()'s own docstring) |
Limitations
- Some Katharevousa forms are explicitly suppressed.
Diachronic paradigm rung (Odyssey)
ModernGreekBackend also powers the final Modern rung of the per-word
diachronic paradigm dropdown (Epic → Classical Attic → Hellenistic → Roman
Koine → Modern) in the Odyssey notebooks, wired via
build_grc_lexicon_tabs(..., el_backend=ModernGreekBackend()). The Ancient
polytonic lemma is normalized to monotonic (poly_to_mono) before inflection;
the rung is shown only when the backend yields a paradigm — words with no
living Modern reflex show no Modern rung (no changed/dead-lemma override map
yet, so archaic-but-inflectable lemmas render as the rule-based backend
produces them).
Backend comparison — vs. unimorph
For el verbs, unimorph-backend-eee
is the other available backend. They differ in coverage shape rather than one
strictly superseding the other. Quick-glance summary — unimorph-backend-eee's
own Limitations
section is the canonical source for the unimorph column's specifics:
| Feature | modern-greek (this package) |
unimorph |
|---|---|---|
| Perfect / pluperfect | periphrastic (έχω/είχα + non-finite, e.g. "έχω γράψει") |
verbal adjective (same form for all persons) |
| Imp Cont vs Imp Aor | correctly distinct | identical (no aspect tag in bundled ell.tsv) |
| Aor 3pl | standard -σαν only | may include -αν variant |
| Particle prefix (θα/να) | not included | stripped on load, re-added on display |
Development
uv sync --dev
uv run pytest
Metadata
Release files for modern-greek-backend-eee 1.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| modern_greek_backend_eee-1.1.0.tar.gz | 55.6 kB | With provenance | Details for modern_greek_backend_eee-1.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| modern_greek_backend_eee-1.1.0-py3-none-any.whl | Python 3 | none | any | Details for modern_greek_backend_eee-1.1.0-py3-none-any.whl |
Total release size: 73.9 kB
Release files / modern_greek_backend_eee-1.1.0.tar.gz
| Download URL | modern_greek_backend_eee-1.1.0.tar.gz |
|---|---|
| Size | 55.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
514e888fba8a520505b4b26c112ddedf32fefea40b6c8844c405b8a054a437ff
|
|
BLAKE2b-256 checksum How to use checksums |
dafd8726cfa08b0a3bc1bc951eda542d8475528d5040f3245d21c66d4d22d8ef
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 7, 2026.
Transparency logRelease files / modern_greek_backend_eee-1.1.0-py3-none-any.whl
| Download URL | modern_greek_backend_eee-1.1.0-py3-none-any.whl |
|---|---|
| Size | 18.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4b23ea3f7ebf8b186b44f44d491d9827640b8e46e0355fb5a100d420a15ecb70
|
|
BLAKE2b-256 checksum How to use checksums |
e1dbedc664619391dc098a095356a05c9e05fc531db5c1b9f0f419d2cfd6789c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 7, 2026.
Transparency logSecurity for modern-greek-backend-eee 1.1.0
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.
Attestation for modern_greek_backend_eee-1.1.0.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 Sep 7, 2026.
Transparency logA 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.