Changelog for Python

General

• Added
  Adds an optional Fast mode for lower-latency OpenAI processing.
• Added
  Adds zero-configuration local vision processing with automatic model downloads and GPU acceleration. (J#NAT-551)
• Changed
  Improves born-digital text extraction by detecting citation markers, footnote numbers, and bracketed references as super/subscript and promoting heading candidates found in the text layer to heading zones.
• Changed
  Improves the agentic vision tier by reporting a structural role for each text zone and promoting high-confidence Title and SectionHeader detector Text zones to headings.
• Changed
  Improves vision layout on born-digital pages by separating larger or bold heading lines inside detected text zones into their own heading zones. This behavior is controlled by splitHeadingsInTextZones, which is on by default.
• Changed
  Improves chart data extraction on multipanel and multilevel charts by asking the model for one table per panel, including the panel title in a <caption>, and folding extra grouping levels into the row label.
• Changed
  Changes the default OpenAI vision model to gpt-5.6-luna.
• Fixed
  Fixes an issue where vision extraction failed with Failed to crop image to zone bounds on born-digital pages whose ruled frame extended past the page box. It also prevents decorative horizontal rules from being admitted as page-wide tables.
• Fixed
  Fixes an issue where License.TraceFeatures returned an empty or single-entry list in trial mode. It now reports every licensed component the application used.

OCR

• Added
  Adds form-field fill-state detection so detected form fields now report whether they’re filled or empty, including checked/unchecked checkboxes, signed/blank signatures, and filled/empty text fields.
• Added
  Adds checkbox and form-field state to Markdown export. Checkboxes render as task-list items, and labeled form fields render as label: value lines.
• Added
  Adds the Ocr.detectLanguageOncePerDocument setting, which controls whether automatic language detection runs once for the whole document or independently on every page.
• Added
  Adds a language tag to Markdown code fences, inferred from the code block’s own content.
• Added
  Adds document splitting, which finds sub-document boundaries in a merged document and returns the page ranges.
• Changed
  Improves Markdown export of text that wraps across lines. A word broken by a hyphen at the end of a line is rejoined into one word, while a wrapped number range keeps its hyphen.
• Changed
  Speeds up automatic OCR language detection by identifying the language from a band of the page instead of the whole page. This behavior is controlled by the new Ocr.detectLanguagePageFraction setting.
• Changed
  Speeds up automatic OCR language detection by running its text-recognition pass for speed rather than accuracy. This behavior is controlled by the new Ocr.detectLanguageFavorAccuracy setting.
• Changed
  Changes zero-shot classification so single-label and multilabel modes may now return different predicted labels and rankings.
• Changed
  Changes table export so a header row detected by the table model is emitted with header cells instead of plain cells.
• Changed
  Changes the classification confidence threshold to apply on each mode’s own confidence scale, so single-label and multilabel documents may abstain differently.
• Changed
  Changes Markdown export to apply inline bold and italic styling to headings and page headers and footers, and to emit runs that are both bold and italic as **_text_** rather than ***text***.
• Changed
  Changes Markdown export to include page headers and footers by default, fenced by page-header and page-footer comment markers.
• Fixed
  Fixes an issue where Markdown export dropped every chart table after the first when a chart held several panels.
• Fixed
  Fixes an issue where table cell column and row spans reached past the end of the table, which produced malformed tables in the Markdown and JSON exports.
• Fixed
  Fixes an issue where table extraction on tall tables whose recognized structure collapsed to a couple of rows lost rows. The table region is now reread in horizontal bands, and the lost rows are recovered.

PDF

• Added
  Adds bold detection from font weight metadata in born-digital PDF text extraction.
• Changed
  Improves text style extraction by detecting underlines in born-digital PDFs and resolving bold and italic styles from font descriptors.

Vision

• Added
  Adds a reasoning-effort setting for AI data extraction and vision zone classification, trading model reasoning time against cost.
• Changed
  Improves chart detection when extracting document content with vision language models.
• Changed
  Improves NLI grounding confidence on numeric table cells by anchoring the verbalized claim to the cell’s printed value and identifying its row by all its columns, so correct numeric extractions no longer receive low groundedness.
• Changed
  Changes AI data extraction to enforce the requested JSON schema on the provider and fall back automatically for models that don’t support it.

General

• Changed
  Improves exception-to-status mappings and adds DocumentConversionFailed and VisionOperationFailed status codes. (J#NAT-603)
• Changed
  Improves first-request latency on GPU deployments by preparing the CUDA runtime during warmup instead of during the first request.
• Changed
  Improves multipage CPU processing throughput by scheduling concurrent page inference on a shared thread pool.
• Fixed
  Fixes GPU memory growing across requests and never being released when vision inference runs on the CUDA provider.

OCR

• Added
  Adds a maximum-threads OCR setting that processes pages concurrently when making a document searchable.
• Added
  Adds offline language detection for Tamil, Telugu, Kannada, Malayalam, and Bengali, with faster script models.
• Changed
  Improves OCR speed on modern x86 processors by using VNNI instructions when available.
• Changed
  Optimizes automatic OCR language detection: detects once per document and skips it when page OCR is disabled.
• Fixed
  Fixes the OCR accuracy-vs.-speed setting being ignored. Disabling accuracy mode now selects the faster recognition path.

PDF

• Added
  Adds a PDF validation API that verifies PDF/A and PDF/UA conformance and produces detailed validation reports.
• Added
  Adds dedicated OCR and PDF editing exception types that identify the failed operation and page.
• Added
  Adds the AutoTaggingEngine accessibility setting to choose between Heuristic, Vision, and VisionVlm tagging.
• Added
  Adds vision-backed layout detection to PDF/UA auto-tagging for higher-fidelity document structure.

PDF

• Fixed
  Fixes MakeSearchable writing every page’s OCR text layer onto the first page of multipage documents.

General

• Added
  Adds GPU-accelerated vision inference on Linux via the WebGPU execution provider on Vulkan-capable GPUs. (J#NAT-560)
• Added
  Adds Windows GPU-accelerated vision inference via the WebGPU execution provider on Direct3D 12. (J#NAT-560)
• Added
  Adds a local in-process vision language model provider for AI document augmentation without a cloud or server dependency. (J#NAT-521)
• Added
  Adds a natural language inference (NLI) groundedness confidence and an opt-in v2 result.json metadata schema for AI document extraction.
• Added
  Adds optional document restoration that enhances extraction for perspective-distorted document photos before extraction. (#2863)
• Added
  Adds support for newer Anthropic models in the Vision API. (J#NAVI-32)
• Added
  Adds support for opening password-protected PDF documents by supplying the password through the document open settings.
• Changed
  Renames Claude vision provider APIs to Anthropic. (J#NAVI-31)
• Fixed
  Fixes a process-exit crash when GPU vision inference is requested on Linux hosts without a Vulkan-capable GPU. (J#NAT-579)
• Fixed
  Fixes document classification reporting only one processed page for multipage documents.
• Fixed
  Fixes error handling to throw proper exceptions for file-not-found and invalid handle states.
• Fixed
  Fixes nullable numeric getters returning errors for unset values in the Java and Python SDKs. (#NATL-586)

OCR

• Fixed
  Fixes AdaptiveOcr extraction failing on PDF pages whose embedded text layer contains no extractable words.

PDF

• Added
  Adds page-level automatic deskewing to the PDF editor.

Templating

• Added
  Adds PowerPoint and Excel template-to-PDF/UA generation via new presentation and spreadsheet editors. (J#NAT-559)

General

• Added
  Adds Vision.GenerateSchema for generating extraction-ready JSON Schemas with optional cross-field constraint rules.
• Added
  Adds a diagnostics artifact to vision document extraction containing VLM token usage and provider context when includeDiagnostics is enabled. (J#NAT-501)
• Added
  Adds automatic orientation correction that straightens pages rotated 90/180/270 degrees before vision extraction. (J#NAVI-18)
• Added
  Adds barcode recognition for 1D, QR, Data Matrix, PDF417, Aztec, Micro QR, and MaxiCode codes in the vision pipeline. (J#NAT-530)
• Added
  Adds page selection to document extraction through a 1-based page-range setting such as 1–3,5. (J#NAT-464)
• Added
  Adds quad-point polygon geometry to document regions for accurate representation of rotated and skewed areas. (J#NAVI-23)
• Added
  Adds ranked BM-25 text search over documents: Build a reusable index, and then query it for passages by page and line. (J#NAT-512)
• Changed
  Improves formula recognition performance, roughly halving processing time on equation-heavy documents. (J#NAT-556)
• Changed
  Improves table extraction speed by up to 6× on table-heavy documents. (J#NAT-524)
• Changed
  Changes vision licensing checks to match exactly the capabilities each API call invokes.
• Changed
  Disables local handwriting OCR by default, with an advanced setting to opt back in. (#2746)
• Changed
  Optimizes vision document extraction with GPU acceleration on macOS, up to ~3× faster. (J#NAT-524, J#NAT-525, J#NAT-537, J#NAT-550, J#NAT-552, J#NAT-554, J#NAT-555, J#NAT-556)
• Changed
  Updates the default OpenAI and Anthropic vision models to gpt-5.4 and claude-sonnet-4-6. (#2964)
• Fixed
  Fixes AI extraction errors mislabeled as an unreachable endpoint when the model returns no content.
• Fixed
  Fixes Markdown table-cell export replacing en/em dashes and minus signs with hyphens and leaving formatting noise.
• Fixed
  Fixes a crash when processing documents concurrently with GPU-accelerated vision. (J#NAT-556)
• Fixed
  Fixes a memory leak where vision objects weren’t released after use, growing native memory over time. (J#NAT-515)
• Fixed
  Fixes an issue where the structured JSON export flattened multiline zones into a single line; zone text now preserves visual line breaks as newlines. (#2771)
• Fixed
  Fixes duplicate paragraph text appearing alongside extracted table content when table extraction is enabled. (#2953)
• Fixed
  Fixes token usage counts to include Gemini thinking tokens and OpenAI cached input tokens.

OCR

• Added
  Adds fully offline language and text-direction detection for documents, with a text-only mode that needs no document.
• Added
  Adds multilingual zero-shot document classification, automatically handling non-English documents and labels.
• Added
  Adds text-only zero-shot classification for text you already have, with no document opened or rendered.
• Added
  Adds zero-shot document classification scoring text and image against caller-supplied labels.
• Changed
  Improves concurrent processing of vision documents. (J#NAVI-21)
• Changed
  Improves offline language detection by suppressing spurious secondary languages via new OCR settings.
• Fixed
  Fixes a race condition that could corrupt results when running vision OCR extraction concurrently. (J#NAVI-19)
• Fixed
  Fixes data tables being misclassified as a table of contents and dropped during vision data extraction.

General

• Changed
  Improves classification for handwriting zones for the VLM pipeline. (#2737)
• Changed
  Improves the Python API reference layout with per-tag folder hierarchies for settings classes. (J#NAT-481)
• Changed
  Changes the OCR setting to support multiple modes, including an automatic mode that selects the best processing pipeline. (#2738)

Office

• Added
  Adds rendering of DisplayBarCode QR code fields in Word documents during conversion. (J#MAMBO-2058)
• Added
  Adds rendering of form checkboxes and dropdowns from ODT documents during conversion. (J#MAMBO-2072)
• Fixed
  Fixes a crash when converting Word documents containing an IF mail-merge field that resolves to an empty result. (J#MAMBO-2076)
• Fixed
  Fixes DOCX repair so footers stored with an invalid hdr root element are corrected to ftr. (J#MAMBO-2078)
• Fixed
  Fixes an invalid image stream exception. (J#MAMBO-2077)
• Fixed
  Fixes MSG files with custom IPM.Note subclasses, such as archived emails, being reported as an unknown format. (J#GDPIC-1621)

PDF

• Changed
  Improves embedded font subsetting with corrected .notdef glyph handling and CFF font reconstruction.
• Changed
  Changes the Producer and Creator metadata of generated PDF documents from GdPicture.NET to Nutrient SDK. (J#NAT-460)
• Fixed
  Fixes PDF/A validation errors related to embedded font glyph and width consistency. (J#PDFA-95)

General

• Added
  Adds a text export format for converting documents to plain text.
• Added
  Adds an opt-in strict structured-output mode for AI data extraction with automatic schema normalization.
• Added
  Adds first-class form-field detection to the Vision API, with optional AI semantic labeling of detected fields.
• Added
  Adds intelligent chart parsing via HTML tables. (J#NAT-457)
• Added
  Adds PNG, JPEG, and BMP support to image export, with automatic format detection from the destination filename. (J#NAT-474)
• Added
  Adds single-flight coordination in ResourceDownloader to coalesce concurrent requests for the same model download. (J#NAT-472)
• Added
  Adds support for primitive, enum, and string-array properties in settings. (J#NAT-107)
• Added
  Adds Vision.ExtractStructured for AI-powered structured data extraction shaped by a caller-supplied JSON Schema.
• Changed
  Improves AI extraction robustness with fail-fast schema validation and culture-independent confidence scoring.
• Changed
  Improves AI model download reliability with integrity validation and automatic retry on failure. (J#NAT-419)
• Changed
  Improves form-field detection by removing overlapping predictions for cleaner, more consistent results. (J#NAT-471)
• Changed
  Improves heuristic PDF layout extraction.
• Changed
  Improves the Office-to-PDF speed tests. (J#MAMBO-2073)
• Removed
  Removes form-field inference from vision intelligent content recognition. (J#NAT-469)
• Fixed
  Fixes intermittent errors in the VlmEnhanced vision pipeline when processing documents concurrently. (J#NAVI-16)
• Fixed
  Fixes the GdPicture.NET.Toolkit NuGet package on .NET Framework 4.6.2 by including native runtimes as a package dependency. (J#GDPIC-1619)
• Fixed
  Fixes incorrect text appearing inside images in multipage document Markdown output. (#2654)
• Fixed
  Fixes loss of image alternate text descriptions when converting documents to PDF/UA. (J#PDFA-93)
• Fixed
  Fixes word alignment in document layout that caused paragraphs to absorb text from neighboring lines. (#2633)

Office

• Changed
  Improves DOCX line spacing rendering for documents using the legacy line spacing compatibility option. (J#MAMBO-2027)
• Changed
  Improves ODT-to-PDF page dimension rendering to match Microsoft Word. (J#MAMBO-2059)
• Changed
  Improves parsing of empty spaces from ODT documents. (J#MAMBO-2075)
• Fixed
  Fixes an exception when loading a Word document that contains an empty custom XML part. (J#MAMBO-2067)
• Fixed
  Fixes an exception when rendering table cells where all text falls outside the cell boundary. (J#MAMBO-2065)
• Fixed
  Fixes missing spacing before a numbered paragraph when the preceding paragraph isn’t part of the list. (J#MAMBO-2062)
• Fixed
  Fixes ODT tables losing their header row. (J#MAMBO-2074)

PDF

• Added
  Adds support for converting between Instant JSON and GdPicture XMP annotations. (J#NAT-406)
• Added
  Adds support for exporting Instant JSON. (J#NAT-397)
• Changed
  Improves PDF-to-Markdown conversion performance.
• Changed
  Enables change tracking for Instant JSON exports by default. (J#NAT-394)
• Fixed
  Fixes empty embedded file handling when merging PDF documents. (J#GDPDF-1520)

Templating

• Added
  Adds PowerPoint (PPTX) templating with placeholders, loops, conditionals, tables, and images to the Office templater. (J#OFTAPI-20)

• Added
  Adds the AdaptiveOcr vision engine — a heuristic-first PDF extraction pipeline with automatic OCR fallback for image-based pages.
• Added
  Adds a born-digital text fast path to VLM pipelines and enables VLM-only text output when OCR is disabled. (#2607)
• Added
  Adds direct PDF processing support to the Vision API for improved document analysis.
• Added
  Adds support for creating searchable PDFs.
• Added
  Adds form detection support.
• Changed
  Improves licensing error information when Document.open fails because the input format requires a feature not enabled by the active license. (J#NAPY-4)
• Changed
  Improves vision data extraction fidelity.
• Fixed
  Fixes ARM64 Windows compatibility issues where the SDK failed with cryptic errors on ARM64 Windows machines. (J#NAPY-6)
• Fixed
  Fixes caption and footnote relationships being linked to incorrect element IDs. (#2615)
• Fixed
  Fixes Document.open to raise FileNotFoundException for missing files. (J#NAPY-1)
• Fixed
  Fixes a crash when running OCR on Linux. (J#NAT-458)
• Fixed
  Fixes the SDK version displayed in the license banner to match the installed wheel version. (J#NAPY-3)
• Changed
  Improves Python SDK conversion, rendering, and extraction capabilities by incorporating enhancements from the Nutrient .NET SDK 14.4.3(opens in a new tab) release line.

• Added
  Adds Markdown export format to Vision API content extraction, including options for semantic block formatting and header/footer inclusion. (J#NAT-347 and #2590)
• Added
  Adds a failure message when VlmEnhancedIcr isn’t configured correctly. (#2534)
• Changed
  Improves SdkSettings accessors with property-style syntax and refines the Python API reference documentation. (J#NAT-441)
• Changed
  Improves Vision API JSON export performance on large multipage documents. (#2499)
• Changed
  Improves Python SDK conversion, rendering, and extraction capabilities by incorporating enhancements from the Nutrient .NET SDK 14.4.2(opens in a new tab) release line.

• Added
  Adds compatibility with Python >=3.8.
• Changed
  Improves Python SDK conversion, rendering, and extraction capabilities by incorporating enhancements from the Nutrient .NET SDK 14.4.1(opens in a new tab) release line.
• Changed
  Improves handwriting vision capabilities by adding a new in-house model that better identifies handwritten regions in images.

• Changed
  Improves Python error handling and exception mapping for clearer, more specific runtime errors. (#2383)
• Changed
  Improves stability and reliability in generated Python bindings. (#2383)

• Fixed
  Fixes XLSX conversion and OCR memory usage issues as part of a coordinated .NET/Java/Python SDK release. (#2309)
• Changed
  Improves the Vision API for intelligent content recognition (ICR) and fixes issues in the vision language model (VLM) pipeline. (#2309)
• Changed
  Improves macOS distribution compatibility for package delivery. (#2309)

• Added
  Adds the first public Python SDK release, with complete feature parity with Nutrient Java SDK(opens in a new tab) (including Vision) and near parity with Nutrient .NET SDK(opens in a new tab). (#2211, #2221)
• Changed
  Positions the SDK for rapid prototyping and as an entry point for complex document manipulation workflows. (#2211, #2221)
• Changed
  Highlights new Python guides(opens in a new tab) and the newly published Python API reference(opens in a new tab) as part of the release. (#2211, #2221)