Registry / data / grobid-client-python

grobid-client-python

library0.1.4pypypi✓ verified 83d ago

Simple Python client for GROBID REST services. Current version: 0.1.4. Release cadence: irregular, with several fixes in 2024-2025.

data http-networking ai-ml

pip install grobid-client-python

github ↗package ↗changelog ↗

INSTALL

IMPORT

SIG · GROBID-CLIENT-PYTH

grobid-client-python

datapythonv0.1.4

Install

4.0s avg

Import

1856ms

Disk

43MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.1.4 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 1.928s · 44.1MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 4.0s · import 1.784s · 45MB

43MB installed

● package 43MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

GrobidClient

✓ from grobid_client.grobid_client import GrobidClient

✗ from grobid_client import GrobidClient

GrobidClient is in grobid_client module, not top-level package

GrobidClient

✓ from grobid_client import GrobidClient

✗ import grobid_client

Importing grobid_client alone does not expose GrobidClient; must import explicitly

Initialize client with default config and process a PDF.

from grobid_client.grobid_client import GrobidClient client = GrobidClient(config_path=None, grobid_server='http://localhost:8070') client.process("processFulltextDocument", "input.pdf", output="output/") print("Done")

Debug

Known issues

gotchaThe client expects a running GROBID server at the specified URL. Without it, all API calls will raise ConnectionError.

fix

Ensure GROBID server is running at the configured grobid_server URL (default: http://localhost:8070).

affects: all

breakingVersion 0.1.0 changed the default output format to JSON and Markdown. The process() method now returns dicts and writes files differently. Old code expecting raw TEI XML may break.

fix

Use generateIDs=True and specify output format parameters like output_format='tei' if needed.

affects: >=0.1.0

gotchaThe batch size default changed to 10 in v0.0.17 to avoid unexpected behaviors. Large batches may cause server timeouts.

fix

Adjust batch_size parameter in client initialization (e.g., GrobidClient(batch_size=100) for larger throughput, but test for stability).

affects: >=0.0.17

gotchaThe client uses synchronous requests. Processing many PDFs can block the calling thread for a long time.

fix

Consider using threading or asyncio wrappers if concurrent processing is needed.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'grobid_client'

The package is installed as 'grobid-client-python', but the import path uses underscore. Mistaking package name for import name.

fix

Install with 'pip install grobid-client-python', then import correctly: from grobid_client.grobid_client import GrobidClient

AttributeError: module 'grobid_client' has no attribute 'GrobidClient'

Trying to import GrobidClient from the top-level grobid_client package without specifying the submodule.

fix

Use: from grobid_client.grobid_client import GrobidClient

ConnectionError: HTTPConnectionPool(host='localhost', port=8070): Max retries exceeded

No GROBID server running at the default URL.

fix

Start GROBID server or provide a different grobid_server URL pointing to a running instance.

ValueError: The 'input' parameter must be a file path or a directory.

Passing a non-existent path or invalid file type (not PDF or XML).

fix

Ensure input exists and is a valid PDF or TEI XML file, or include a directory containing such files.

Upgrade

Version history

0.1.4latest on PyPI · released Jan 9, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

10 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/kermitt2/grobid_client_python ↗

packagehttps://pypi.org/project/grobid-client-python/ ↗

changeloghttps://github.com/kermitt2/grobid_client_python ↗