Skip to main content

A python wrapper for the Doc2X API and comes with native texts processing (to improve texts recall in RAG).

Project description

pdfdeal

Package Testing on Python 3.8-3.13 on Win/Linux/macOS

Downloads GitHub License PyPI - Version GitHub Repo stars


📄Documentation


🗺️ ENGLISH | 简体中文

Handle PDF more easily and simply, utilizing Doc2X's powerful document conversion capabilities for retained format file conversion/RAG enhancement.

Introduction

Doc2X Support

Doc2X is a new universal document OCR tool that can convert images or PDF files into Markdown/LaTeX text with formulas and text formatting. It performs better than similar tools in most scenarios. pdfdeal provides abstract packaged classes to use Doc2X for requests.

Processing PDFs

Use various OCR or PDF recognition tools to identify images and add them to the original text. You can set the output format to use PDF, which will ensure that the recognized text retains the same page numbers as the original in the new PDF. It also offers various practical file processing tools.

After conversion and pre-processing of PDF using Doc2X, you can achieve better recognition rates when used with knowledge base applications such as graphrag, Dify, and FastGPT.

Cases

graphrag

See how to use it with graphrag, its not supported to recognize pdf, but you can use the CLI tool doc2x to convert it to a txt document for use.

Fastgpt/Dify or other RAG system

Or for knowledge base applications, you can use pdfdeal's built-in variety of enhancements to documents, such as uploading images to remote storage services, adding breaks by paragraph, etc. See Integration with RAG applications.

Documentation

For details, please refer to the documentation

Or check out the documentation repository pdfdeal-docs.

Quick Start

For details, please refer to the documentation

Installation

Install using pip:

pip install --upgrade pdfdeal

If you need document processing tools:

pip install --upgrade "pdfdeal[rag]"

Use the Doc2X PDF API to process all PDF files in a specified folder

from pdfdeal import Doc2X

client = Doc2X(apikey="Your API key",debug=True)
success, failed, flag = client.pdf2file(
    pdf_file="tests/pdf",
    output_path="./Output",
    output_format="docx",
)
print(success)
print(failed)
print(flag)

Use the Doc2X PDF API to process the specified PDF file and specify the name of the exported file

from pdfdeal import Doc2X

client = Doc2X(apikey="Your API key",debug=True)
success, failed, flag = client.pdf2file(
    pdf_file="tests/pdf/sample.pdf",
    output_path="./Output/test/single/pdf2file",
    output_names=["sample1.zip"],
    output_format="md_dollar",
)
print(success)
print(failed)
print(flag)

See the online documentation for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pdfdeal-0.4.8b1.tar.gz (111.4 kB view details)

Uploaded Source

Built Distribution

pdfdeal-0.4.8b1-py3-none-any.whl (42.3 kB view details)

Uploaded Python 3

File details

Details for the file pdfdeal-0.4.8b1.tar.gz.

File metadata

  • Download URL: pdfdeal-0.4.8b1.tar.gz
  • Upload date:
  • Size: 111.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for pdfdeal-0.4.8b1.tar.gz
Algorithm Hash digest
SHA256 325fe9d322d83fab1f914a2691aa0f3fe097c6f0f9066f079f0e37b8b2e3e0bb
MD5 6b7a5337bfa806677d92478330478d1c
BLAKE2b-256 bc12ca05db95c7c4b00194427e480c62ee3940bd209465f1b74377aeaed3e13a

See more details on using hashes here.

Provenance

The following attestation bundles were made for pdfdeal-0.4.8b1.tar.gz:

Publisher: python-publish.yml on Menghuan1918/pdfdeal

Attestations:

File details

Details for the file pdfdeal-0.4.8b1-py3-none-any.whl.

File metadata

  • Download URL: pdfdeal-0.4.8b1-py3-none-any.whl
  • Upload date:
  • Size: 42.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for pdfdeal-0.4.8b1-py3-none-any.whl
Algorithm Hash digest
SHA256 490bd7f4b701d2dc6ceba376a947a9b1e2d017d20bcab73826fb5a3e7f914bfd
MD5 b9ea9b63f9bba6cffa6bc7d8e6997ac7
BLAKE2b-256 fb4601ab40b3fa1b88fb87a02b1b89640cb188284c72d23bc85c152546c2f238

See more details on using hashes here.

Provenance

The following attestation bundles were made for pdfdeal-0.4.8b1-py3-none-any.whl:

Publisher: python-publish.yml on Menghuan1918/pdfdeal

Attestations:

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page