PyDelphin — Python libraries for DELPH-IN data

Python Support

DELPH-IN is an international consortium of researchers committed to producing precise, high-quality language processing tools and resources, primarily in the HPSG syntactic and MRS semantic frameworks, and PyDelphin is a suite of Python libraries for processing data and interacting with tools in the DELPH-IN ecosystem. PyDelphin's goal is to lower the barriers to making use of DELPH-IN resources to help users quickly build applications or perform experiments, and it has been successfully used for research into machine translation (e.g., Goodman, 2018), sentence chunking (Muszyńska, 2016), neural semantic parsing (Buys & Blunsom, 2017), natural language generation (Hajdik et al., 2019), and more.

Documentation, including guides and an API reference, is available here: http://pydelphin.readthedocs.io/

New to PyDelphin? Want to see examples? Try the walkthrough.

Installation and Upgrading

Get the latest release of PyDelphin from PyPI:

$ pip install pydelphin

For more information about requirements, installing from source, and running unit tests, please see the documentation.

API changes in new versions are documented in the CHANGELOG, but for any unexpected changes please file an issue.

Features

PyDelphin contains the following modules:

Semantic Representations:

Semantic Components, Interfaces, and Metrics:

delphin.semi: Semantic Interface
delphin.vpm: Variable Property Mapping
delphin.variable: MRS variables
delphin.predicate: Semantic Predicates
delphin.scope: Underspecified scope
delphin.sembase: Basic semantic structures
delphin.codecs: A wide variety of serialization codecs for MRS, EDS, and DMRS
delphin.edm: Elementary Dependency Match

Grammar and Parse Inspection:

delphin.derivation: Derivation trees
delphin.tdl: Type-Description Language
delphin.tfs: Feature structures and type hierarchies

Tokenization:

delphin.repp: Regular-Expression PreProcessor
delphin.tokens: YY Token lattices
delphin.lnk: Lnk surface alignments

Corpus Management and Processing:

delphin.itsdb: [incr tsdb()] profiles
delphin.tsdb: Low-level interface to test suite databases
delphin.tsql: TSQL test suite queries

Interfaces with External Processors:

delphin.interface: Structures for interacting with external processors
delphin.ace: Python wrapper for common tasks using ACE
delphin.web: Client for the web API

Core Components and Command Line Interface:

delphin.commands: Functional interface to common tasks
delphin.cli: Command-line interface to functional commands
delphin.hierarchy: Multiple-inheritance hierarchies
delphin.exceptions: PyDelphin's basic exception classes

Miscellaneous:

delphin.highlight: Pygments lexers and styles for highlighting MRS and TDL

Other Information

Getting Help

Please use the issue tracker for bug reports, feature requests, and documentation requests. For more general questions and support, try one of the following channels maintained by the DELPH-IN community:

DELPH-IN Discourse forums
developers mailing list

Citation

Please use the following for academic citations (and see: https://ieeexplore.ieee.org/abstract/document/8939628):

@INPROCEEDINGS{Goodman:2019,
  author={Goodman, Michael Wayne},
  title={A Python Library for Deep Linguistic Resources},
  booktitle={2019 Pacific Neighborhood Consortium Annual Conference and Joint Meetings (PNC)},
  year={2019},
  month=oct,
  address={Singapore},
  keywords={research software;linguistics;semantics;HPSG;computational linguistics;natural language processing;open source software}
}

Acknowledgments

Thanks to PyDelphin's contributors and all who've participated by filing issues and feature requests. Also thanks to the users of PyDelphin!

Related Software

Parser/Generators (chronological order)
Grammar profiling, testing, and analysis
- [incr tsdb()]: http://www.delph-in.net/itsdb/
- gDelta: https://github.com/ned2/gdelta
- Typediff: https://github.com/ned2/typediff
Software libraries and repositories
- LOGON: https://github.com/delph-in/docs/wiki/LogonTop
- pydmrs: https://github.com/delph-in/pydmrs
Also see (may have overlap with the above):
- https://github.com/delph-in/docs/wiki/ToolsTop
- https://github.com/delph-in/docs/wiki/DelphinApplications

Spelling

Earlier versions of PyDelphin were spelled "pyDelphin" with a lower-case "p" and this form is used in several publications. The current recommended spelling has an upper-case "P".

Metadata

Release files for PyDelphin 1.11.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 PyDelphin 1.11.0
File	Size	Uploaded
pydelphin-1.11.0.tar.gz	308.8 kB	Mar 31, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for PyDelphin 1.11.0
File	Interpreter	ABI	Platform	Reset
pydelphin-1.11.0-py3-none-any.whl 191.2 kB Mar 31, 2026	Python 3	none	any	Details

Total release size: 500.0 kB

Release files / pydelphin-1.11.0.tar.gz

Download URL	pydelphin-1.11.0.tar.gz
Size	308.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`580d5a564964070a8127450baead4955aa74020870078b15aa838b662aaa0cf7`
BLAKE2b-256 checksum How to use checksums	`ec34a8be7f7ff78ca107b63954035abab086abf5eff1505c0dc1b73ab5d9b908`
Upload date	Mar 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/delph-in/pydelphin
Publishing commit: github.com/delph-in/pydelphin/tree/d2730dead4de704b5331c38fb650ece1b79dd6c2

Workflow

Publishing configuration: github.com/delph-in/pydelphin/blob/d2730dead4de704b5331c38fb650ece1b79dd6c2/.github/workflows/publish.yml
Publishing logs: github.com/delph-in/pydelphin/actions/runs/23781532841/attempts/1

Artifact

Subject: pydelphin-1.11.0.tar.gz
SHA-256 checksum: 580d5a564964070a8127450baead4955aa74020870078b15aa838b662aaa0cf7 Verifying attestations

Release files / pydelphin-1.11.0-py3-none-any.whl

Download URL	pydelphin-1.11.0-py3-none-any.whl
Size	191.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`09eada1952b608e65a02c2f32918552c22b3e80b1b09891426af8cc378f5e682`
BLAKE2b-256 checksum How to use checksums	`1c7ed87d616a7a5294b6af889cfaa3d7e04d867477249fa6c240f49d812eb1a7`
Upload date	Mar 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/delph-in/pydelphin
Publishing commit: github.com/delph-in/pydelphin/tree/d2730dead4de704b5331c38fb650ece1b79dd6c2

Workflow

Publishing configuration: github.com/delph-in/pydelphin/blob/d2730dead4de704b5331c38fb650ece1b79dd6c2/.github/workflows/publish.yml
Publishing logs: github.com/delph-in/pydelphin/actions/runs/23781532841/attempts/1

Artifact

Subject: pydelphin-1.11.0-py3-none-any.whl
SHA-256 checksum: 09eada1952b608e65a02c2f32918552c22b3e80b1b09891426af8cc378f5e682 Verifying attestations