ulpi-io Nutrient Document Processing
Process, convert, extract, redact, sign, and manipulate documents using the Nutrient DWS Processor API.
Setup
You need a Nutrient DWS API key. Get one free at https://dashboard.nutrient.io/sign_up/?product=processor.
Export the API key before running scripts:
export NUTRIENT_API_KEY="nutr_sk_..."
Scripts live in scripts/ relative to this SKILL.md. Use the directory containing this SKILL.md as the working directory when running scripts:
cd <directory containing this SKILL.md> && uv run scripts/<script>.py --help
Page ranges use start:end (0-based, end-exclusive). Negative indices count from the end. Use comma-separated ranges like 0:2,3:5,-2:-1.
PDF Requirements
Some operations require specific document characteristics:
- split.py: Requires multi-page PDFs (2+ pages). Cannot extract a range from a single-page document.
- delete-pages.py: Must retain at least one page. Cannot delete all pages in a document.
- sign.py: Only accepts local file paths (not URLs).
Single-Operation Scripts
- Convert format:
uv run scripts/convert.py --input doc.pdf --format docx --out doc.docx - Merge files:
uv run scripts/merge.py --inputs a.pdf,b.pdf --out merged.pdf - Split by ranges:
uv run scripts/split.py --input doc.pdf --ranges 0:2,2: --out-dir out --prefix part - OCR:
uv run scripts/ocr.py --input scan.pdf --languages english --out scan-ocr.pdf - Rotate pages:
uv run scripts/rotate.py --input doc.pdf --angle 90 --out rotated.pdf - Optimize:
uv run scripts/optimize.py --input doc.pdf --out optimized.pdf - Extract text:
uv run scripts/extract-text.py --input doc.pdf --out text.json - Extract tables:
uv run scripts/extract-table.py --input doc.pdf --out tables.json - Extract key-value pairs:
uv run scripts/extract-key-value-pairs.py --input doc.pdf --out kvp.json - Add text watermark:
uv run scripts/watermark-text.py --input doc.pdf --text CONFIDENTIAL --out watermarked.pdf - AI redact:
uv run scripts/redact-ai.py --input doc.pdf --criteria "Remove all SSNs" --mode apply --out redacted.pdf - Sign:
uv run scripts/sign.py --input doc.pdf --out signed.pdf - Password protect:
uv run scripts/password-protect.py --input doc.pdf --user-password upass --owner-password opass --out protected.pdf - Add pages:
uv run scripts/add-pages.py --input doc.pdf --count 2 --out with-pages.pdf - Delete pages:
uv run scripts/delete-pages.py --input doc.pdf --pages 0,2,-1 --out trimmed.pdf - Duplicate/reorder pages:
uv run scripts/duplicate-pages.py --input doc.pdf --pages 2,0,1,1 --out reordered.pdf
Multi-Step Workflow Rule
Do not add new committed pipeline scripts under scripts/.
When the user asks for multiple operations in one run:
- Copy
assets/templates/custom-workflow-template.pyto a temporary location (for example/tmp/ndp-workflow-<task>.py). - Implement the combined workflow in that temporary script.
- Run it with
uv run /tmp/ndp-workflow-<task>.py .... - Return generated output files.
- Delete the temporary script unless the user explicitly asks to keep it.
Rules
- Fail fast when required arguments are missing.
- Write outputs to explicit paths and print created files.
- Do not log secrets.
- All client methods are async and should run via
asyncio.run(main()). - If import fails, install dependency with
uv add nutrient-dws.