# Using PyMuPDF as Data Feeder in LLM / RAG Applications
This package converts the pages of a PDF to text in Markdown format using [PyMuPDF](https://pypi.org/project/PyMuPDF/).
Standard text and tables are detected, brought in the right reading sequence and then together converted to GitHub-compatible Markdown text.
Header lines are identified via the font size and appropriately prefixed with one or more '#' tags.
Bold, italic, mono-spaced text and code blocks are detected and formatted accordingly. Similar applies to ordered and unordered lists.
By default, all document pages are processed. If desired, a subset of pages can be specified by providing a list of 0-based page numbers.
# Installation
```bash
$ pip install -U pdf4llm
```
> This command will automatically install [PyMuPDF](https://github.com/pymupdf/PyMuPDF) if required.
Then in your script do:
```python
import pdf4llm
md_text = pdf4llm.to_markdown("input.pdf")
# now work with the markdown text, e.g. store as a UTF8-encoded file
import pathlib
pathlib.Path("output.md").write_bytes(md_text.encode())
```
Instead of the filename string as above, one can also provide a PyMuPDF `Document`. By default, all pages in the PDF will be processed. If desired, the parameter `pages=[...]` can be used to provide a list of zero-based page numbers to consider.
**New features as of v0.0.8:**
* Support for pages with **_multiple text columns_**.
* Support for **_image and vector graphics extraction_**:
1. Specify `pdf4llm.to_markdown("input.pdf", write_images=True)`. Default is `False`.
2. Each image or vector graphic on the page will be extracted and stored as a PNG image named `"input.pdf-pno-index.png"` in the folder of `"input.pdf"`. Where `pno` is the 0-based page number and `index` is some sequence number.
3. The image files will have width and height equal to the values on the page.
4. Any text contained in the images or graphics will not be extracted, but become visible as image parts.
* Support for **page chunks**: Instead of returning one large string for the whole document, a list of dictionaries can be generated: one for each page. Specify `data = pdf4llm.to_markdown("input.pdf", page_chunks=True)`. Then, for instance the first item, `data[0]` will contain a dictionary for the first page with the text and some metadata.
* As a first example for directly supporting LLM / RAG consumers, this version can output **LlamaIndex documents**:
```python
import pdf4llm
md_read = LlamaMarkdownReader()
data = md_read.load_data("input.pdf")
# The result 'data' is of type List[LlamaIndexDocument]
# Every list item contains metadata and the markdown text of 1 page.
```
* A LlamaIndex document essentially corresponds to Python dictionary, where the markdown text of the page is one of the dictionary values. For instance the text of the first page is the the value of `data[0].to_dict().["text"]`.
* For details, please consult LlamaIndex documentation.
* Upon creation of the `LlamaMarkdownReader` all necessary LlamaIndex-related imports are executed. Required related package installations must have been done independently and will not be checked during pdf4llm installation.
Raw data
{
"_id": null,
"home_page": "https://github.com/pymupdf/RAG",
"name": "pdf4llm",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Artifex",
"author_email": "support@artifex.com",
"download_url": "https://files.pythonhosted.org/packages/42/e0/0cfed6dcb634e40f7de7aab63892589fb0b94970da6fa9fdc927c46e9fba/pdf4llm-0.0.9.tar.gz",
"platform": null,
"description": "# Using PyMuPDF as Data Feeder in LLM / RAG Applications\r\n\r\nThis package converts the pages of a PDF to text in Markdown format using [PyMuPDF](https://pypi.org/project/PyMuPDF/).\r\n\r\nStandard text and tables are detected, brought in the right reading sequence and then together converted to GitHub-compatible Markdown text.\r\n\r\nHeader lines are identified via the font size and appropriately prefixed with one or more '#' tags.\r\n\r\nBold, italic, mono-spaced text and code blocks are detected and formatted accordingly. Similar applies to ordered and unordered lists.\r\n\r\nBy default, all document pages are processed. If desired, a subset of pages can be specified by providing a list of 0-based page numbers.\r\n\r\n\r\n# Installation\r\n\r\n```bash\r\n$ pip install -U pdf4llm\r\n```\r\n\r\n> This command will automatically install [PyMuPDF](https://github.com/pymupdf/PyMuPDF) if required.\r\n\r\nThen in your script do:\r\n\r\n```python\r\nimport pdf4llm\r\n\r\nmd_text = pdf4llm.to_markdown(\"input.pdf\")\r\n\r\n# now work with the markdown text, e.g. store as a UTF8-encoded file\r\nimport pathlib\r\npathlib.Path(\"output.md\").write_bytes(md_text.encode())\r\n```\r\n\r\nInstead of the filename string as above, one can also provide a PyMuPDF `Document`. By default, all pages in the PDF will be processed. If desired, the parameter `pages=[...]` can be used to provide a list of zero-based page numbers to consider.\r\n\r\n**New features as of v0.0.8:**\r\n\r\n* Support for pages with **_multiple text columns_**.\r\n* Support for **_image and vector graphics extraction_**:\r\n\r\n 1. Specify `pdf4llm.to_markdown(\"input.pdf\", write_images=True)`. Default is `False`.\r\n 2. Each image or vector graphic on the page will be extracted and stored as a PNG image named `\"input.pdf-pno-index.png\"` in the folder of `\"input.pdf\"`. Where `pno` is the 0-based page number and `index` is some sequence number.\r\n 3. The image files will have width and height equal to the values on the page.\r\n 4. Any text contained in the images or graphics will not be extracted, but become visible as image parts.\r\n\r\n* Support for **page chunks**: Instead of returning one large string for the whole document, a list of dictionaries can be generated: one for each page. Specify `data = pdf4llm.to_markdown(\"input.pdf\", page_chunks=True)`. Then, for instance the first item, `data[0]` will contain a dictionary for the first page with the text and some metadata.\r\n\r\n* As a first example for directly supporting LLM / RAG consumers, this version can output **LlamaIndex documents**:\r\n\r\n ```python\r\n import pdf4llm\r\n \r\n md_read = LlamaMarkdownReader()\r\n data = md_read.load_data(\"input.pdf\")\r\n\r\n # The result 'data' is of type List[LlamaIndexDocument]\r\n # Every list item contains metadata and the markdown text of 1 page.\r\n ```\r\n\r\n * A LlamaIndex document essentially corresponds to Python dictionary, where the markdown text of the page is one of the dictionary values. For instance the text of the first page is the the value of `data[0].to_dict().[\"text\"]`.\r\n * For details, please consult LlamaIndex documentation.\r\n * Upon creation of the `LlamaMarkdownReader` all necessary LlamaIndex-related imports are executed. Required related package installations must have been done independently and will not be checked during pdf4llm installation.\r\n",
"bugtrack_url": null,
"license": "GNU AFFERO GPL 3.0",
"summary": "PyMuPDF Utilities for LLM/RAG",
"version": "0.0.9",
"project_urls": {
"Homepage": "https://github.com/pymupdf/RAG"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "970fc9771bbf11cf78bcd68139cc2ec6887982eae09d3b111a3bbd700ef6a739",
"md5": "62bebffc2856791aa1ca2207da9b0f63",
"sha256": "98188f4ed6b78e93fa9cfceb102b82ae1893f97933023126493fdb35de53cf51"
},
"downloads": -1,
"filename": "pdf4llm-0.0.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "62bebffc2856791aa1ca2207da9b0f63",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 3015,
"upload_time": "2024-05-21T01:58:23",
"upload_time_iso_8601": "2024-05-21T01:58:23.422322Z",
"url": "https://files.pythonhosted.org/packages/97/0f/c9771bbf11cf78bcd68139cc2ec6887982eae09d3b111a3bbd700ef6a739/pdf4llm-0.0.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "42e00cfed6dcb634e40f7de7aab63892589fb0b94970da6fa9fdc927c46e9fba",
"md5": "01d9b470b0b4b22d15b95d52a710d4ce",
"sha256": "616340e1e8df370b6b138b5e82755b3b29e78226145abb89011ba92e71b3b859"
},
"downloads": -1,
"filename": "pdf4llm-0.0.9.tar.gz",
"has_sig": false,
"md5_digest": "01d9b470b0b4b22d15b95d52a710d4ce",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 3125,
"upload_time": "2024-05-21T01:58:21",
"upload_time_iso_8601": "2024-05-21T01:58:21.386936Z",
"url": "https://files.pythonhosted.org/packages/42/e0/0cfed6dcb634e40f7de7aab63892589fb0b94970da6fa9fdc927c46e9fba/pdf4llm-0.0.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-21 01:58:21",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pymupdf",
"github_project": "RAG",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "pdf4llm"
}
JSON
