Skip to main content

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

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.7.1.tar.gz (439.9 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.7.1-pp311-pypy311_pp73-win_amd64.whl (464.7 kB view details)

Uploaded PyPyWindows x86-64

reynir-3.7.1-pp311-pypy311_pp73-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (442.0 kB view details)

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

reynir-3.7.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl (437.9 kB view details)

Uploaded PyPymacOS 11.0+ ARM64

reynir-3.7.1-pp311-pypy311_pp73-macosx_10_15_x86_64.whl (437.4 kB view details)

Uploaded PyPymacOS 10.15+ x86-64

reynir-3.7.1-cp310-abi3-win_amd64.whl (440.0 kB view details)

Uploaded CPython 3.10+Windows x86-64

reynir-3.7.1-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (512.9 kB view details)

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

reynir-3.7.1-cp310-abi3-macosx_11_0_arm64.whl (443.8 kB view details)

Uploaded CPython 3.10+macOS 11.0+ ARM64

reynir-3.7.1-cp310-abi3-macosx_10_9_x86_64.whl (443.8 kB view details)

Uploaded CPython 3.10+macOS 10.9+ x86-64

File details

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

File metadata

  • Download URL: reynir-3.7.1.tar.gz
  • Upload date:
  • Size: 439.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for reynir-3.7.1.tar.gz
Algorithm Hash digest
SHA256 bd24af43990aa5041a64ee3a1ca947d87ed7850c770630084b98ea5972ffa95f
MD5 8e62be756d79069e2dffdf223d2fdf8b
BLAKE2b-256 25d17a6c4804cde54ba43e817af889f0fe202ac8ac1674670ae1c7504432e190

See more details on using hashes here.

Provenance

The following attestation bundles were made for reynir-3.7.1.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.7.1-pp311-pypy311_pp73-win_amd64.whl.

File metadata

File hashes

Hashes for reynir-3.7.1-pp311-pypy311_pp73-win_amd64.whl
Algorithm Hash digest
SHA256 9df50e3ec9b6919227d3c49f7650289aba981b4d35a7cd8a5ecd9ae67a5d057e
MD5 d8c125760fc639443e876d0fa3775909
BLAKE2b-256 b22aa88a604178fbaf8b1f784e6a843b3847ad23000f4e06368d6c3ac4de2c12

See more details on using hashes here.

Provenance

The following attestation bundles were made for reynir-3.7.1-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.7.1-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.7.1-pp311-pypy311_pp73-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 d48bb73a50f534d31f761296074feb5ac31499b211bda22dca7194624443c39d
MD5 fd0463cc374415eba1c29cff1f145e38
BLAKE2b-256 0d3a9b66fd7ed7831dd3e331e5d03b570f4bae6657e01b8ee1aaa4c6125099f4

See more details on using hashes here.

Provenance

The following attestation bundles were made for reynir-3.7.1-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.7.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for reynir-3.7.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 6856b7fde19d7e7a21fca3d4f99b171d0791dee2b6025b13e8400739891d666e
MD5 7072c787ff16445ce654a9119782e6e9
BLAKE2b-256 2c4ad52df8d52f921952b78f3308e41d4ce7f441a48f42b524bb55f01c272b38

See more details on using hashes here.

Provenance

The following attestation bundles were made for reynir-3.7.1-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.7.1-pp311-pypy311_pp73-macosx_10_15_x86_64.whl.

File metadata

File hashes

Hashes for reynir-3.7.1-pp311-pypy311_pp73-macosx_10_15_x86_64.whl
Algorithm Hash digest
SHA256 82bb491e17f3bbc44af77179e2d59597db5554ab6ecc2e5b3e01376b0b23ddb3
MD5 a5dba16f6b78d53cdf76d887509d1b55
BLAKE2b-256 b03ef0fde35d7cebff9058b9178c0be8dae5dca960eb23039f3d88209c53ad60

See more details on using hashes here.

Provenance

The following attestation bundles were made for reynir-3.7.1-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.7.1-cp310-abi3-win_amd64.whl.

File metadata

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

File hashes

Hashes for reynir-3.7.1-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 861ca8ec3a2800dad5136a22d44af19f24a02a6b0a4ddbc5b59f5a6fb4a8cf69
MD5 b67beec5a1c75c7aecb9ef80a769be74
BLAKE2b-256 22e667832e19e02af261ea8ce3940d5886ea79c6abe6580beb489774f5d4c096

See more details on using hashes here.

Provenance

The following attestation bundles were made for reynir-3.7.1-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.7.1-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for reynir-3.7.1-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 a15d21cbd4e562191b5df347ec5533a59e2c05427fd01065080aa2fe2dd53633
MD5 b5f250ff9f65667014f040e11861e8ca
BLAKE2b-256 14ea8344221c62ccdd0b53829f56d29e7752d1761b56b26bcc1c0caab5be0fa5

See more details on using hashes here.

Provenance

The following attestation bundles were made for reynir-3.7.1-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.7.1-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for reynir-3.7.1-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 4fd1551a4696783b66a4f7aad5ec169f785d1d300803c90bd53c110fb4a24215
MD5 6ec01035e0ca20eec9e15970b87b93f7
BLAKE2b-256 92ba552d87de17538ea0921f7975fc0e1d70c463557a72140a82c0a8132c4ece

See more details on using hashes here.

Provenance

The following attestation bundles were made for reynir-3.7.1-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.7.1-cp310-abi3-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for reynir-3.7.1-cp310-abi3-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 b537b978a214c5b5ce4ffbb9d054c4a73ecff79e3fa53e58511aeb2bff5c150c
MD5 a5b1ab5f397f4910265f1f784476120c
BLAKE2b-256 08ae3fad55c2723f343e9a85841f9f5c5e85e2d9ad5b793fb64c3e08da06fd01

See more details on using hashes here.

Provenance

The following attestation bundles were made for reynir-3.7.1-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