lum-ai / odinson   0.6.1

Apache License 2.0 Website GitHub

Odinson is a powerful and highly optimized open-source framework for rule-based information extraction. Odinson couples a simple, yet powerful pattern language that can operate over multiple representations of text, with a runtime system that operates in near real time.

Scala versions: 2.12

Tests (GitHub Actions) codecov


Odinson can be used to rapidly query a natural language knowledge base and extract structured relations. Query patterns can be designed over (a) surface, syntax, or a combination of both. In particular, Odinson has been highly optimized to deliver these results in near real-time, which enables users to dynamically develop queries, receiving immediate feedback on the coverage and precision of the patterns at scale. Please see our LREC 2020 paper for technical details and evaluation.


Please see for documentation, including information about installation, capabilities, and learning how to build queries.

Project overview

Odinson supports a wide range of features, including:

  • Patterns over tokens, including boolean patterns over token features like lemma, POS tags, NER tags, chunk tags, etc
  • Patterns over syntax by matching paths in a dependency graph. Note that this actually agnostic to the tags in the graph edges and it could be repurposed for matching over semantic roles or something else.
  • Named captures for extracting the different entities involved in a relation
  • Support for greedy and lazy quantifiers, lookaround assertions, etc.
  • Support for an internal state to hold intermediate mentions, allowing for the application of patterns in a cascade
  • Support for grammars
  • Filtering results by document metadata (e.g., authors, publication date)
  • and much, much more!

Again, please see our documentation for more information!

We would also love to hear any questions, requests, or suggestions you may have.


If you would like to contribute to this project with code, rule sets, or other repo material, that's awesome! Please do! Some of these materials will help you get started:

  • There is a document covering some of the technical issues related to contributing like the Pull Request Process and Formatting Tips.
  • We do ask you to be nice, and we spell that out in a Covenant Code of Conduct. Of course you can expect the same behavior of us.
  • Please ensure the contributions you propose are yours to give and you are comfortable with the shared rights. There is a Contributor License Agreement (CLA) that you will sign before a pull request is accepted so there are no surprises for any of us. Please take a look at the CLA before you get too far, just in case, as there are legal ramifications.

Thanks for your interest in Odinson!