Practical overview
When it fits
Use it when a Python application needs UDPipe model outputs through spaCy Language and Doc objects, particularly for multilingual text or an existing local UDPipe model.
Who it is for
- Python developers building text-processing applications with spaCy.
- Teams seeking pretrained UDPipe models for multilingual annotation in a spaCy workflow.
- Developers who have a local UDPipe model and want to load it through spaCy.
Documented uses
- Add tokenization and linguistic annotation to an existing spaCy pipeline.
- Create annotated Docs for downstream NLP processing.
- Load a custom UDPipe model from a local file.
Requirements & limits
- The README describes pretrained model coverage for more than 50 languages and links to a list of supported models.
- Input may be raw text, presegmented text or pretokenized text.
- The library sets token attributes in its custom Tokenizer, leaving the spaCy Language.pipeline empty.
- Language-specific tag maps may be needed for XPOS-to-UD POS mappings and morphological features; noun-chunk extraction requires a language-specific syntax iterator.
- The library source is MIT-licensed, while the README lists pretrained models under CC BY-NC-SA 4.0.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Process text with a pretrained language model
Install Spacy Udpipe, obtain a pretrained model, and create a spaCy Doc containing token annotations.
Before you start
- Python environment with pip
- A language code for a supported pretrained UDPipe model
Steps
Install the package with the command below.
pip install spacy-udpipeIn Python, import
spacy_udpipeand download the selected model withspacy_udpipe.download("en"), replacingenwith the desired language code.Load the model with
spacy_udpipe.load("en")and pass text to the returned Language object.Read token attributes such as
lemma_,pos_anddep_from the resulting Doc.
Expected outcome
A spaCy Doc whose tokens expose the documented linguistic attributes.
Guide limitations
- Available pretrained models vary by supported language; consult the project’s languages list.
- The README describes UDPipe models as faster but slightly less accurate than Stanza models.
- Language-specific tag maps and syntax iterators may be needed for mappings, morphology or noun-chunk extraction.
Load a local UDPipe model into spaCy
Create a spaCy Language object using a custom UDPipe model file.
Before you start
- Python environment with Spacy Udpipe installed
- A local UDPipe model file and its language code
Steps
Import
spacy_udpipe.Call
spacy_udpipe.load_from_pathwith the language code, model-file path and metadata.Pass text to the returned Language object and read token attributes from the resulting Doc.
Expected outcome
A spaCy Doc processed with the supplied local UDPipe model.
Guide limitations
- The README demonstrates the method with a Croatian model and says it can be used for languages supported by spaCy.
- Language-specific spaCy defaults, tag maps and syntax iterators can affect available mappings and parsing utilities.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 14 October 2026
- Original website title
- TakeLab/spacy-udpipe · Official homepage title · retained in its source language

