Registry / ai-ml / nv-ingest-client

nv-ingest-client

library26.3.0pypypiunverified

nv-ingest-client is a Python client for NVIDIA's nv-ingest service, enabling ingestion and preprocessing of documents (PDF, DOCX, etc.) into structured data. Current version is 26.3.0, with active development and weekly releases. The primary use case is sending documents to the service and receiving annotated results.

ai-ml http-networking

pip install nv-ingest-client

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · NV-INGEST-CLIENT

nv-ingest-client

ai-mlpythonv26.3.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

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

IngestClient

✓ from nv_ingest_client import IngestClient

✗ from nv_ingest_client.client import IngestClient

Minimal example to instantiate IngestClient and ingest a PDF.

import os from nv_ingest_client.client import IngestClient, IngestClientConfig # Configure client config = IngestClientConfig( host=os.environ.get('NV_INGEST_HOST', 'localhost'), port=os.environ.get('NV_INGEST_PORT', '8000') ) client = IngestClient(config) # Ingest a document result = client.ingest_file("example.pdf") print(result)

Debug

Known issues

breakingVersion 26.x renamed the main package from 'nv_ingest' to 'nv_ingest_client'. Old imports like 'from nv_ingest.client import IngestClient' will break.

fix

Use 'from nv_ingest_client.client import IngestClient'.

affects: >=26.0.0

gotchaThe client requires a running nv-ingest service. Connecting to a non-existent host or port will hang for the default timeout (60s). Always set a timeout.

fix

Pass the 'timeout' parameter to IngestClientConfig (e.g., timeout=10).

affects: all

deprecatedThe 'ingest_file' method is deprecated in favor of 'ingest_document' for async workflows. 'ingest_file' still works but may be removed in a future version.

fix

Use 'client.ingest_document('example.pdf')' instead.

affects: >=26.0.0

Upgrade

Version history

26.3.0latest on PyPI · released Mar 16, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

8 hits · last 30 days

node

Resources

githubhttps://github.com/NVIDIA/nv-ingest ↗

packagehttps://pypi.org/project/nv-ingest-client/ ↗

docshttps://docs.nvidia.com/nv-ingest ↗