Irchel Geoparser

A Python library for extracting place names from text and linking them to geographic locations.

Features

Project-Based Workflows: Store documents and results in a persistent database for long-term research
Modular Architecture: Mix and match different recognizers and resolvers, or build your own
Trainable Models: Fine-tune recognizers and resolvers on your own annotated data
Custom Gazetteers: Integrate any geographic database through simple YAML configuration

Installation

pip install geoparser

Quick Start

from geoparser import Geoparser

# Initialize with default settings
gp = Geoparser()

# Parse text
text = "Paris is the capital of France."
docs = gp.parse(text)

# Access results
for toponym in docs[0].toponyms:
    print(f"{toponym.text} -> {toponym.location.data}")

Documentation

Full documentation is available at docs.geoparser.app

Contributing

Questions, bug reports, and ideas are always welcome via issues. Pull requests are appreciated too — see CONTRIBUTING.md for local setup and development guidelines.

Acknowledgments

The Irchel Geoparser originated as part of my Master's thesis and was further developed with support from the Department of Geography at the University of Zurich and the Public Data Lab of the Digitalization Initiative of the Zurich Higher Education Institutions. I thank Prof. Dr. Ross Purves for the opportunity to continue this work as part of a research project.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Third-party licenses are listed in THIRD_PARTY_LICENSES.

Download files

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

Source Distribution

geoparser-0.5.0.tar.gz (389.2 kB view details)

Uploaded Jul 26, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

geoparser-0.5.0-py3-none-any.whl (137.8 kB view details)

Uploaded Jul 26, 2026 Python 3

File details

Details for the file geoparser-0.5.0.tar.gz.

File metadata

Download URL: geoparser-0.5.0.tar.gz
Upload date: Jul 26, 2026
Size: 389.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for geoparser-0.5.0.tar.gz
Algorithm	Hash digest
SHA256	`84e8b72cfc156f967e69873b89391e265431b1bc4730084673babea83a9b1e08`
MD5	`459f6ed3d6d32f1c4e50e280b48a9994`
BLAKE2b-256	`c35d8f17e0ab9b16edfb116de5c81ea19da1c42c2d371568a032176b932e1415`

See more details on using hashes here.

Provenance

The following attestation bundles were made for geoparser-0.5.0.tar.gz:

Publisher: ci.yml on dguzh/geoparser

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: geoparser-0.5.0.tar.gz
- Subject digest: 84e8b72cfc156f967e69873b89391e265431b1bc4730084673babea83a9b1e08
- Sigstore transparency entry: 2256409075
- Sigstore integration time: Jul 26, 2026
Source repository:
- Permalink: dguzh/geoparser@51f3c760c28c964085fdd77139fb04c7c24f1e4d
- Branch / Tag: refs/tags/0.5.0
- Owner: https://github.com/dguzh
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: ci.yml@51f3c760c28c964085fdd77139fb04c7c24f1e4d
- Trigger Event: push