License: MIT Python 3.10 Release PyPI Build

Greynir

GreynirEngine

A fast, efficient natural language processing engine for Icelandic

Overview

Greynir is a Python 3 (>=3.10) package, published by Miðeind ehf., for working with Icelandic natural language text. Greynir can parse text into sentence trees, find lemmas, inflect noun phrases, assign part-of-speech tags and much more.

Greynir's sentence trees can inter alia be used to extract information from text, for instance about people, titles, entities, facts, actions and opinions.

Full documentation for Greynir is available here.

Greynir is the engine of Greynir.is, a natural-language front end for a database of over 10 million sentences parsed from Icelandic news articles, and Embla, a voice-driven virtual assistant app for smart devices such as iOS and Android phones.

Greynir includes a hand-written context-free grammar for the Icelandic language, consisting of over 7,000 lines of grammatical productions in extended Backus-Naur format. Its fast C++ parser core is able to cope with long and ambiguous sentences, using an Earley-type parser as enhanced by Scott and Johnstone.

Greynir employs the Tokenizer package, by the same authors, to tokenize text, and uses BinPackage as its database of Icelandic vocabulary and morphology.

Examples

Use Greynir to easily inflect noun phrases

from reynir import NounPhrase as Nl

# Create a NounPhrase ('nafnliður') object
karfa = Nl("þrír lúxus-miðar á Star Wars og tveir brimsaltir pokar af poppi")

# Print the NounPhrase in the correct case for each context
# (þf=þolfall/accusative, þgf=þágufall/dative). Note that
# the NounPhrase class implements __format__(), allowing you
# to use the case as a format specification, for instance in f-strings.

print(f"Þú keyptir {karfa:þf}.")
print(f"Hér er kvittunin þín fyrir {karfa:þgf}.")

The program outputs the following text, correctly inflected:

Þú keyptir þrjá lúxus-miða á Star Wars og tvo brimsalta poka af poppi.
Hér er kvittunin þín fyrir þremur lúxus-miðum á Star Wars og tveimur brimsöltum pokum af poppi.

Use Greynir to parse a sentence

>>> from reynir import Greynir
>>> g = Greynir()
>>> sent = g.parse_single("Ása sá sól.")
>>> print(sent.tree.view)
P                               # Root
+-S-MAIN                        # Main sentence
    +-IP                          # Inflected phrase
    +-NP-SUBJ                   # Noun phrase, subject
        +-no_et_nf_kvk: 'Ása'     # Noun, singular, nominative, feminine
    +-VP                        # Verb phrase containing arguments
        +-VP                      # Verb phrase containing verb
        +-so_1_þf_et_p3: 'sá'   # Verb, 1 accusative arg, singular, 3rd p
        +-NP-OBJ                  # Noun phrase, object
        +-no_et_þf_kvk: 'sól'   # Noun, singular, accusative, feminine
+-'.'                           # Punctuation
>>> sent.tree.nouns
['Ása', 'sól']
>>> sent.tree.verbs
['sjá']
>>> sent.tree.flat
'P S-MAIN IP NP-SUBJ no_et_nf_kvk /NP-SUBJ VP so_1_þf_et_p3
    NP-OBJ no_et_þf_kvk /NP-OBJ /VP /IP /S-MAIN p /P'
>>> # The subject noun phrase (S.IP.NP also works)
>>> sent.tree.S.IP.NP_SUBJ.lemmas
['Ása']
>>> # The verb phrase
>>> sent.tree.S.IP.VP.lemmas
['sjá', 'sól']
>>> # The object within the verb phrase (S.IP.VP.NP also works)
>>> sent.tree.S.IP.VP.NP_OBJ.lemmas
['sól']

Extracting lemmas and POS tags for web display

Greynir preserves the original text of each token, including surrounding whitespace. This allows you to reconstruct the exact original input while annotating it with linguistic information such as lemmas and part-of-speech (POS) tags.

from reynir import Greynir

g = Greynir()
sent = g.parse_single("Ása   sá   sól.")

# Build a map from token index to terminal node
terminal_map = {node.index: node for node in sent.terminal_nodes}

html_parts = []
for i, tok in enumerate(sent.tokens):
    # tok.original preserves the original text with spacing
    original = tok.original or ""
    if i in terminal_map:
        node = terminal_map[i]
        # Wrap with linguistic info (lemma and POS tag)
        html_parts.append(
            f'<span data-lemma="{node.lemma}" data-pos="{node.tcat}">'
            f'{original}</span>'
        )
    else:
        html_parts.append(original)

html = "".join(html_parts)
print(html)

The program outputs the following HTML, with the original spacing preserved and each token annotated with its lemma and POS tag (no=noun, so=verb):

<span data-lemma="Ása" data-pos="no">Ása</span><span data-lemma="sjá" data-pos="so">   sá</span><span data-lemma="sól" data-pos="no">   sól</span><span data-lemma="." data-pos="">.</span>

Prerequisites

This package runs on CPython 3.10 or newer, and on PyPy 3.11 or newer.

To find out which version of Python you have, enter:

python --version

If a binary wheel package isn't available on PyPI for your system, you may need to have the python3-dev package (or its Windows equivalent) installed on your system to set up Greynir successfully. This is because a source distribution install requires a C++ compiler and linker:

# Debian or Ubuntu
sudo apt-get install python3-dev

Depending on your system, you may also need to install libffi-dev:

# Debian or Ubuntu
sudo apt-get install libffi-dev

Installation

To install this package, assuming Python 3 is your default Python:

pip install reynir

If you have git installed and want to be able to edit the source, do like so:

git clone https://github.com/mideind/GreynirEngine
cd GreynirEngine
# [ Activate your virtualenv here if you have one ]
pip install -e .

The package source code is in GreynirEngine/src/reynir.

Tests

To run the built-in tests, cd to your GreynirEngine subdirectory and, using uv, run:

uv sync
uv run pytest

Alternatively, install pytest into your virtualenv and run python -m pytest.

Evaluation

A parsing test pipeline for different parsing schemas, including the Greynir schema, has been developed. It is available here.

Documentation

Please consult Greynir's documentation for detailed installation instructions, a quickstart guide, and reference information, as well as important information about copyright and licensing.

Troubleshooting

GreynirEngine uses a lock file, located alongside the binary grammar file within the package directory (reynir/Greynir.grammar.bin.lock), to serialize the (re)generation of the binary grammar between processes. If a process gets stuck holding the lock, parser initialization fails after a timeout with an error message identifying the lock file. Terminate the process holding the lock, or - if no such process exists - delete the lock file named in the error message, and try again.

Copyright and licensing

Greynir is Copyright © 2016-2025 by Miðeind ehf.. The original author of this software is Vilhjálmur Þorsteinsson.

Miðeind ehf.

This software is licensed under the MIT License:

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

If you would like to use this software in ways that are incompatible with the standard MIT license, contact Miðeind ehf. to negotiate custom arrangements.

GreynirEngine indirectly embeds the Database of Icelandic Morphology, (Beygingarlýsing íslensks nútímamáls), abbreviated BÍN. GreynirEngine does not claim any endorsement by the BÍN authors or copyright holders.

The BÍN source data are publicly available under the CC BY-SA 4.0 license, as further detailed here in English and here in Icelandic.

In accordance with the BÍN license terms, credit is hereby given as follows:

Beygingarlýsing íslensks nútímamáls. Stofnun Árna Magnússonar í íslenskum fræðum. Höfundur og ritstjóri Kristín Bjarnadóttir.

Project links

Data verified by PyPI on Aug 5, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

3 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for haukurpj from gravatar.com haukurpj Avatar for sveinbjornt from gravatar.com sveinbjornt Avatar for vthorsteinsson from gravatar.com vthorsteinsson

Credits

Author/Maintainer: Miðeind ehf.

GitHub Statistics

Data verified by PyPI on Aug 5, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Tags

nlp parser icelandic

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

reynir-3.8.0.tar.gz (445.7 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

reynir-3.8.0-pp311-pypy311_pp73-win_amd64.whl (467.0 kB view details)

Uploaded PyPyWindows x86-64

reynir-3.8.0-pp311-pypy311_pp73-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (444.4 kB view details)

Uploaded PyPymanylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

reynir-3.8.0-pp311-pypy311_pp73-macosx_11_0_arm64.whl (440.4 kB view details)

Uploaded PyPymacOS 11.0+ ARM64

reynir-3.8.0-pp311-pypy311_pp73-macosx_10_15_x86_64.whl (439.8 kB view details)

Uploaded PyPymacOS 10.15+ x86-64

reynir-3.8.0-cp310-abi3-win_amd64.whl (442.4 kB view details)

Uploaded CPython 3.10+Windows x86-64

reynir-3.8.0-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (515.7 kB view details)

Uploaded CPython 3.10+manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

reynir-3.8.0-cp310-abi3-macosx_11_0_arm64.whl (446.6 kB view details)

Uploaded CPython 3.10+macOS 11.0+ ARM64

reynir-3.8.0-cp310-abi3-macosx_10_9_x86_64.whl (446.6 kB view details)

Uploaded CPython 3.10+macOS 10.9+ x86-64

File details

Details for the file reynir-3.8.0.tar.gz.

File metadata

  • Download URL: reynir-3.8.0.tar.gz
  • Upload date:
  • Size: 445.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for reynir-3.8.0.tar.gz
Algorithm Hash digest
SHA256 921d1a39435e6bdd7f28627eb0f8a52074f3f30fd7646a9e26bffff3bedcf22a
MD5 1c3f1d11ea0c216b6b6aed3b1a2b3cca
BLAKE2b-256 1bc16b0874df77d250d152559892e1b2b9f124642e5d2f2ff788aedd64a49bfa

See more details on using hashes here.

Provenance

The following attestation bundles were made for reynir-3.8.0.tar.gz:

Publisher: wheels.yml on mideind/GreynirEngine

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file reynir-3.8.0-pp311-pypy311_pp73-win_amd64.whl.

File metadata

File hashes

Hashes for reynir-3.8.0-pp311-pypy311_pp73-win_amd64.whl
Algorithm Hash digest
SHA256 90cce6120f68930ec54b1eb2e5ec12bcc9a83af30f09a7aec30efa79b2cabe0a
MD5 82287f4af08fd279a221ad17078cad0f
BLAKE2b-256 3a13382a8e6acff6316ef3e655d8cb6551f226ea599a00f0948995dd8d9d8b69

See more details on using hashes here.

Provenance

The following attestation bundles were made for reynir-3.8.0-pp311-pypy311_pp73-win_amd64.whl:

Publisher: wheels.yml on mideind/GreynirEngine

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file reynir-3.8.0-pp311-pypy311_pp73-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for reynir-3.8.0-pp311-pypy311_pp73-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 e5947313be259f7ea753eacea07ee51217a0ebe8396e45024da3989de9e04f46
MD5 6f3c66157c09f771b456b45a68678c11
BLAKE2b-256 cebc799e89cb5cbb6c0bc0868c26272534de59b7a27d690e506ee98d3bf3a419

See more details on using hashes here.

Provenance

The following attestation bundles were made for reynir-3.8.0-pp311-pypy311_pp73-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl:

Publisher: wheels.yml on mideind/GreynirEngine

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file reynir-3.8.0-pp311-pypy311_pp73-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for reynir-3.8.0-pp311-pypy311_pp73-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 3e602b7a275720c63bf9a157af908eff34968b0e97512183bcc89d0d2a70417c
MD5 27b53a2baa5d2aa9c16dd77bd896f526
BLAKE2b-256 95ae08b30e0f7fc544674ba3f1675174d998be0c275ba02497f4f9687181ff01

See more details on using hashes here.

Provenance

The following attestation bundles were made for reynir-3.8.0-pp311-pypy311_pp73-macosx_11_0_arm64.whl:

Publisher: wheels.yml on mideind/GreynirEngine

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file reynir-3.8.0-pp311-pypy311_pp73-macosx_10_15_x86_64.whl.

File metadata

File hashes

Hashes for reynir-3.8.0-pp311-pypy311_pp73-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 eb71016fd856a2f15d6231acdd38b68cb4df588cace36ff1be43c29182494ae7
MD5 0003d35687eadab0de1a8bbd2dfdb484
BLAKE2b-256 cb31bb86076d9e4345f637464a868ec403d045ffe3c4fab2867f991ffdf51efa

See more details on using hashes here.

Provenance

The following attestation bundles were made for reynir-3.8.0-pp311-pypy311_pp73-macosx_10_15_x86_64.whl:

Publisher: wheels.yml on mideind/GreynirEngine

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file reynir-3.8.0-cp310-abi3-win_amd64.whl.

File metadata

  • Download URL: reynir-3.8.0-cp310-abi3-win_amd64.whl
  • Upload date:
  • Size: 442.4 kB
  • Tags: CPython 3.10+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for reynir-3.8.0-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 f70992c54be5a0fbff3885bae65739e4c362cff00efe368f4be1ca0783ccfdde
MD5 7c014a572785e2edbb4c003beb570d67
BLAKE2b-256 7d331ad618cd02ff77cebf25148e6389c4dc6548beeada9bd82dad0fb6c58452

See more details on using hashes here.

Provenance

The following attestation bundles were made for reynir-3.8.0-cp310-abi3-win_amd64.whl:

Publisher: wheels.yml on mideind/GreynirEngine

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file reynir-3.8.0-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for reynir-3.8.0-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 10b6c0cab799ec239afa09733f2a8613a7cb179c018297c558cce5851a13042d
MD5 a21a7e9a81d3bdc6db150a8285faac54
BLAKE2b-256 982ecd60c3f3a63b488d08ef7bb09ab4b85f57210fd9a784ccf6c74c15f4cc75

See more details on using hashes here.

Provenance

The following attestation bundles were made for reynir-3.8.0-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl:

Publisher: wheels.yml on mideind/GreynirEngine

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file reynir-3.8.0-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for reynir-3.8.0-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 8619e473524a2d7208b45e008b2d395d5ab7bd365fa93db5acdb2f9dacae9c83
MD5 47e3c273e9d55c9cb5cf4c64a50f45a2
BLAKE2b-256 daf23318612d480719a75c8f20a674c7caa1f5cf7a74d2acb51908877d2df960

See more details on using hashes here.

Provenance

The following attestation bundles were made for reynir-3.8.0-cp310-abi3-macosx_11_0_arm64.whl:

Publisher: wheels.yml on mideind/GreynirEngine

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file reynir-3.8.0-cp310-abi3-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for reynir-3.8.0-cp310-abi3-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 8838109a4464b517ab9f3c97683e72246179eeb912793a3199ad85fc66692f3d
MD5 d8a5def5a8a8b800bad9482b31cefbfb
BLAKE2b-256 15dff7745eb6c0d3f2bc7116166978993a8dd7566cf989d38368a22549357c9c

See more details on using hashes here.

Provenance

The following attestation bundles were made for reynir-3.8.0-cp310-abi3-macosx_10_9_x86_64.whl:

Publisher: wheels.yml on mideind/GreynirEngine

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page