natural-pdf 0.1.20__tar.gz → 0.1.21__tar.gz

{natural_pdf-0.1.20/natural_pdf.egg-info → natural_pdf-0.1.21}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: natural-pdf
-Version: 0.1.20
+Version: 0.1.21
 Summary: A more intuitive interface for working with PDFs
 Author-email: Jonathan Soma <jonathan.soma@gmail.com>
 License-Expression: MIT
@@ -88,14 +88,28 @@ Natural PDF lets you find and extract content from PDFs using simple code that m
 pip install natural-pdf
 ```
 
-For optional features like specific OCR engines, layout analysis models, or the interactive Jupyter widget, you can install one to two million different extras. If you just want the greatest hits:
+Need OCR engines, layout models, or other heavy add-ons? Install the **core** once, then use the helper CLI to pull in exactly what you need:
 
 ```bash
-# deskewing, OCR (surya) + layout analysis (yolo), interactive browsing
-pip install natural-pdf[favorites]
+# add PaddleOCR (+paddlex) after the fact
+npdf install paddle
+
+# Surya OCR and the YOLO Doc-Layout detector in one go
+npdf install surya yolo
+
+# see what's already on your machine
+npdf list
+```
+
+Light-weight extras such as `deskew` or `search` can still be added with
+classic PEP-508 markers if you prefer:
+
+```bash
+pip install "natural-pdf[deskew]"
+pip install "natural-pdf[search]"
 ```
 
-See the [installation guide](https://jsoma.github.io/natural-pdf/installation/) for more details on extras.
+More details in the [installation guide](https://jsoma.github.io/natural-pdf/installation/).
 
 ## Quick Start
 

{natural_pdf-0.1.20 → natural_pdf-0.1.21}/README.md

@@ -15,14 +15,28 @@ Natural PDF lets you find and extract content from PDFs using simple code that m
 pip install natural-pdf
 ```
 
-For optional features like specific OCR engines, layout analysis models, or the interactive Jupyter widget, you can install one to two million different extras. If you just want the greatest hits:
+Need OCR engines, layout models, or other heavy add-ons? Install the **core** once, then use the helper CLI to pull in exactly what you need:
 
 ```bash
-# deskewing, OCR (surya) + layout analysis (yolo), interactive browsing
-pip install natural-pdf[favorites]
+# add PaddleOCR (+paddlex) after the fact
+npdf install paddle
+
+# Surya OCR and the YOLO Doc-Layout detector in one go
+npdf install surya yolo
+
+# see what's already on your machine
+npdf list
+```
+
+Light-weight extras such as `deskew` or `search` can still be added with
+classic PEP-508 markers if you prefer:
+
+```bash
+pip install "natural-pdf[deskew]"
+pip install "natural-pdf[search]"
 ```
 
-See the [installation guide](https://jsoma.github.io/natural-pdf/installation/) for more details on extras.
+More details in the [installation guide](https://jsoma.github.io/natural-pdf/installation/).
 
 ## Quick Start
 

{natural_pdf-0.1.20 → natural_pdf-0.1.21}/docs/installation/index.md

@@ -30,6 +30,38 @@ pip install natural-pdf[favorites]
 
 Other OCR and layout analysis engines like `surya`, `easyocr`, `paddle`, `doctr`, and `docling` can be installed via `pip` as needed. The library will provide you with an error message and installation command if you try to use an engine that isn't installed.
 
+After the core install you have two ways to add **optional engines**:
+
+### 1 · Helper CLI (recommended)
+
+```bash
+# list optional groups and their install-status
+npdf list
+
+# install PaddleOCR stack
+npdf install paddle
+
+# install Surya OCR + YOLO layout detector
+npdf install surya yolo
+```
+
+The CLI runs each wheel in its own resolver pass, so it avoids strict
+version pins like `paddleocr → paddlex==3.0.1` while still upgrading to
+`paddlex 3.0.2`.
+
+### 2 · Classic extras (for the light stuff)
+
+```bash
+# Deskewing
+pip install "natural-pdf[deskew]"
+
+# Semantic search service
+pip install "natural-pdf[search]"
+```
+
+If you attempt to use an engine that is missing, the library will raise an
+error that tells you which `npdf install …` command to run.
+
 ## Your First PDF Extraction
 
 Here's a quick example to make sure everything is working: