Skip to main content

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:

💬 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 → key el (default backend for Modern Greek)
  • eee_project.named_backends.v1 → key modern-greek (selectable via backend="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)

Source distribution for modern-greek-backend-eee 1.1.0
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)

Table of built distributions (wheels) for modern-greek-backend-eee 1.1.0
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 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.

Release history Release notifications | RSS feed

This release

1.1.0 This release

2 release files Full provenance

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