Practical overview
When it fits
Use it when an application needs spaCy dependency parsing over HTTP or when NLP should run as a separate Docker service.
Who it is for
- Developers integrating spaCy NLP into applications written in other programming languages.
- Teams running NLP as a separate Docker-based microservice.
Documented uses
- Send text to a REST endpoint and receive dependency-parse data.
- View dependency parses through the included displaCy interface.
- Run NLP separately from calling services and scale its service instances independently.
Requirements & limits
- The README lists model images for English, German, Spanish, French, Portuguese, Italian and Dutch, plus a base image without a language model.
- The API loads models at container startup, which may take a few minutes depending on model size and server performance.
- The README describes the API as incompatible with the previous one and identifies separate English and German legacy images.
- Only basic tokenizer special cases are described, configured through a comma-delimited environment variable.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Start the English spaCy API container
Launch the documented English image with its service port bound to localhost.
Before you start
- Docker
Steps
Run the command below.
docker run -p "127.0.0.1:8080:80" jgontrum/spacyapi:en_v2Allow for model loading at startup; the README says this may take a few minutes depending on model size and server performance.
Use the documented
/uipath for the displaCy frontend, or send a JSON request toPOST /depwith text and a model identifier.
Expected outcome
An English spaCy REST service is launched with its port bound to localhost; the documented interface includes dependency parsing and a visualization frontend.
Guide limitations
- The documented example uses the en_v2 image and binds the service to 127.0.0.1:8080.
- The README identifies spaCy 2.0.16 and warns that this API is incompatible with the previous API.
- Model loading time varies with model size and server performance.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 17 October 2026
- Original website title
- jgontrum/spacy-api-docker · Official homepage title · retained in its source language

