Metadata-Version: 2.4
Name: pdf-image-kit
Version: 0.1.1
Summary: Extract embedded, inline, rendered, and vector-backed images from PDF files
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: PyMuPDF<2,>=1.26

# pdf-image-kit

`pdf-image-kit` is a standalone PDF image extraction package focused on pulling candidate images out of PDF files.

## Features

- Extracts embedded bitmap images
- Extracts inline image blocks
- Renders page clips as a fallback when needed
- Captures large vector drawing regions
- Supports both file output and in-memory extraction

## Installation

```bash
pip install pdf-image-kit
```

## Python Usage

```python
from pdf_image_kit import extract_images, extract_images_from_bytes

manifest = extract_images(
    pdf_path="/path/to/demo.pdf",
    output_dir="./out/demo",
    min_width=1,
    min_height=1,
    render_dpi=216,
    dedupe=True,
    vector_min_width=80,
    vector_min_height=60,
    vector_padding=6,
)

print(manifest["exported_images"])
```

## CLI

```bash
pdf-image-extract /path/to/demo.pdf -o ./out
```
