A fast, helpful, and open-source document parser
fix: fix paddleocr and easyocr
Clelia (Astra) Bertelli2ff47a148890
diff --git a/ocr/easyocr/README.md b/ocr/easyocr/README.mdindex 84ad41e..66bf724 100644--- a/ocr/easyocr/README.md+++ b/ocr/easyocr/README.md@@ -4,6 +4,15 @@ This is a simple Flask server that wraps EasyOCR to conform to the LiteParse OCR## Build and Run+**With uv**++```bash+# install and run (in one command)+uv run python3 server.py+```++**With Docker**+```bash# Build Docker imagedocker build -t liteparse-easyocr .@@ -84,3 +93,11 @@ const parser = new LiteParse({const result = await parser.parse('document.pdf');```++## Testing++If you make changes to the server, make sure to adapt and run tests:++```bash+uv run pytest test_server.py+```diff --git a/ocr/easyocr/pyproject.toml b/ocr/easyocr/pyproject.tomlindex 16af8b9..b2adaaf 100644--- a/ocr/easyocr/pyproject.toml+++ b/ocr/easyocr/pyproject.toml@@ -12,3 +12,9 @@ dependencies = ["python-multipart>=0.0.22","uvicorn>=0.41.0",]++[dependency-groups]+dev = [+ "httpx>=0.28.1",+ "pytest>=9.0.2",+]diff --git a/ocr/easyocr/server.py b/ocr/easyocr/server.pyindex 88500a9..78c933f 100644--- a/ocr/easyocr/server.py+++ b/ocr/easyocr/server.py@@ -62,8 +62,9 @@ class EasyOCRServer:if isinstance(coords, np.ndarray):coords = coords.tolist()- xs = [point[0] for point in coords]- ys = [point[1] for point in coords]+ # int casting is necessary for pydantic serialization (np.Int32 are not serializable)+ xs = [int(point[0]) for point in coords]+ ys = [int(point[1]) for point in coords]bbox = [min(xs), min(ys), max(xs), max(ys)]formatted.append(diff --git a/ocr/easyocr/server_test_script.py b/ocr/easyocr/server_test_script.pydeleted file mode 100644index 9220052..0000000--- a/ocr/easyocr/server_test_script.py+++ /dev/null@@ -1,8 +0,0 @@-import requests--with open("/Users/clee/Downloads/receipt.png", "rb") as f:- files = {"file": ("receipt.png", f, "image/png")}- data = {"language": "en"}- url = "http://localhost:8828"- response = requests.post(f"{url}/ocr", files=files, data=data)- print(response.json())diff --git a/ocr/easyocr/test_server.py b/ocr/easyocr/test_server.pynew file mode 100644index 0000000..6f3d64c--- /dev/null+++ b/ocr/easyocr/test_server.py@@ -0,0 +1,65 @@+import io+from typing import Any++import pytest+from fastapi.testclient import TestClient+from PIL import Image++from server import EasyOCRServer++[email protected](scope="module")+def server() -> EasyOCRServer:+ return EasyOCRServer()+++class MockEasyOCRReader:+ def __init__(self, *args, **kwargs) -> None:+ self.results = [+ ([[10, 20], [200, 40]], "Hello World", 0.98),+ ([[10, 50], [250, 70]], "Total: $42.00", 0.95),+ ([[10, 80], [180, 100]], "Thank you!", 0.87),+ ]+ self.transformed_results = [+ {"text": "Hello World", "bbox": [10, 20, 200, 40], "confidence": 0.98},+ {"text": "Total: $42.00", "bbox": [10, 50, 250, 70], "confidence": 0.95},+ {"text": "Thank you!", "bbox": [10, 80, 180, 100], "confidence": 0.87},+ ]++ def readtext(self, *args, **kwargs) -> list[Any]:+ return self.results+++def test_server_init(server: EasyOCRServer) -> None:+ assert server.current_language is None+ assert server.reader is None+++def test_server_health_endpoint(server: EasyOCRServer) -> None:+ app = server._create_ocr_server()+ client = TestClient(app)+ response = client.get("/health")+ assert response.status_code == 200+ assert response.json() == {"status": "healthy"}+++def test_server_ocr_endpoint(server: EasyOCRServer) -> None:+ image = Image.new("RGB", (1, 1), color=(255, 255, 255))++ # Save to bytes (to simulate a file upload)+ buffer = io.BytesIO()+ image.save(buffer, format="PNG")+ buffer.seek(0)+ app = server._create_ocr_server()+ mock_ocr = MockEasyOCRReader()+ server.reader = mock_ocr # type: ignore+ server.current_language = "en"+ client = TestClient(app)++ response = client.post(+ "/ocr",+ files={"file": ("test.png", buffer, "image/png")},+ data={"language": "en"},+ )+ assert response.status_code == 200+ assert response.json().get("results", []) == mock_ocr.transformed_resultsdiff --git a/ocr/easyocr/uv.lock b/ocr/easyocr/uv.lockindex d675484..f27f717 100644--- a/ocr/easyocr/uv.lock+++ b/ocr/easyocr/uv.lock@@ -33,6 +33,15 @@ wheels = [{ url = "https://files.pythonhosted.org/packages/38/0e/27be9fdef66e72d64c0cdc3cc2823101b80585f8119b5c112c2e8f5f7dab/anyio-4.12.1-py3-none-any.whl", hash = "sha256:d405828884fc140aa80a3c667b8beed277f1dfedec42ba031bd6ac3db606ab6c", size = 113592, upload-time = "2026-01-06T11:45:19.497Z" },]+[[package]]+name = "certifi"+version = "2026.1.4"+source = { registry = "https://pypi.org/simple" }+sdist = { url = "https://files.pythonhosted.org/packages/e0/2d/a891ca51311197f6ad14a7ef42e2399f36cf2f9bd44752b3dc4eab60fdc5/certifi-2026.1.4.tar.gz", hash = "sha256:ac726dd470482006e014ad384921ed6438c457018f4b3d204aea4281258b2120", size = 154268, upload-time = "2026-01-04T02:42:41.825Z" }+wheels = [+ { url = "https://files.pythonhosted.org/packages/e6/ad/3cc14f097111b4de0040c83a525973216457bbeeb63739ef1ed275c1c021/certifi-2026.1.4-py3-none-any.whl", hash = "sha256:9943707519e4add1115f44c2bc244f782c0249876bf51b6599fee1ffbedd685c", size = 152900, upload-time = "2026-01-04T02:42:40.15Z" },+]+[[package]]name = "click"version = "8.3.1"@@ -112,6 +121,12 @@ dependencies = [{ name = "uvicorn" },]+[package.dev-dependencies]+dev = [+ { name = "httpx" },+ { name = "pytest" },+]+[package.metadata]requires-dist = [{ name = "easyocr", specifier = ">=1.7.2" },@@ -122,6 +137,12 @@ requires-dist = [{ name = "uvicorn", specifier = ">=0.41.0" },]+[package.metadata.requires-dev]+dev = [+ { name = "httpx", specifier = ">=0.28.1" },+ { name = "pytest", specifier = ">=9.0.2" },+]+[[package]]name = "fastapi"version = "0.132.0"@@ -165,6 +186,34 @@ wheels = [{ url = "https://files.pythonhosted.org/packages/04/4b/29cac41a4d98d144bf5f6d33995617b185d14b22401f75ca86f384e87ff1/h11-0.16.0-py3-none-any.whl", hash = "sha256:63cf8bbe7522de3bf65932fda1d9c2772064ffb3dae62d55932da54b31cb6c86", size = 37515, upload-time = "2025-04-24T03:35:24.344Z" },]+[[package]]+name = "httpcore"+version = "1.0.9"+source = { registry = "https://pypi.org/simple" }+dependencies = [+ { name = "certifi" },+ { name = "h11" },+]+sdist = { url = "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8", size = 85484, upload-time = "2025-04-24T22:06:22.219Z" }+wheels = [+ { url = "https://files.pythonhosted.org/packages/7e/f5/f66802a942d491edb555dd61e3a9961140fd64c90bce1eafd741609d334d/httpcore-1.0.9-py3-none-any.whl", hash = "sha256:2d400746a40668fc9dec9810239072b40b4484b640a8c38fd654a024c7a1bf55", size = 78784, upload-time = "2025-04-24T22:06:20.566Z" },+]++[[package]]+name = "httpx"+version = "0.28.1"+source = { registry = "https://pypi.org/simple" }+dependencies = [+ { name = "anyio" },+ { name = "certifi" },+ { name = "httpcore" },+ { name = "idna" },+]+sdist = { url = "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406, upload-time = "2024-12-06T15:37:23.222Z" }+wheels = [+ { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },+]+[[package]]name = "idna"version = "3.11"@@ -187,6 +236,15 @@ wheels = [{ url = "https://files.pythonhosted.org/packages/fb/fe/301e0936b79bcab4cacc7548bf2853fc28dced0a578bab1f7ef53c9aa75b/imageio-2.37.2-py3-none-any.whl", hash = "sha256:ad9adfb20335d718c03de457358ed69f141021a333c40a53e57273d8a5bd0b9b", size = 317646, upload-time = "2025-11-04T14:29:37.948Z" },]+[[package]]+name = "iniconfig"+version = "2.3.0"+source = { registry = "https://pypi.org/simple" }+sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" }+wheels = [+ { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },+]+[[package]]name = "jinja2"version = "3.1.6"@@ -609,6 +667,15 @@ wheels = [{ url = "https://files.pythonhosted.org/packages/ec/d2/de599c95ba0a973b94410477f8bf0b6f0b5e67360eb89bcb1ad365258beb/pillow-12.1.1-cp314-cp314t-win_arm64.whl", hash = "sha256:7b03048319bfc6170e93bd60728a1af51d3dd7704935feb228c4d4faab35d334", size = 2546446, upload-time = "2026-02-11T04:22:50.342Z" },]+[[package]]+name = "pluggy"+version = "1.6.0"+source = { registry = "https://pypi.org/simple" }+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" }+wheels = [+ { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },+]+[[package]]name = "pyclipper"version = "1.4.0"@@ -725,6 +792,31 @@ wheels = [{ url = "https://files.pythonhosted.org/packages/f7/07/34573da085946b6a313d7c42f82f16e8920bfd730665de2d11c0c37a74b5/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:76d0819de158cd855d1cbb8fcafdf6f5cf1eb8e470abe056d5d161106e38062b", size = 2139017, upload-time = "2025-11-04T13:42:59.471Z" },]+[[package]]+name = "pygments"+version = "2.19.2"+source = { registry = "https://pypi.org/simple" }+sdist = { url = "https://files.pythonhosted.org/packages/b0/77/a5b8c569bf593b0140bde72ea885a803b82086995367bf2037de0159d924/pygments-2.19.2.tar.gz", hash = "sha256:636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887", size = 4968631, upload-time = "2025-06-21T13:39:12.283Z" }+wheels = [+ { url = "https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b", size = 1225217, upload-time = "2025-06-21T13:39:07.939Z" },+]++[[package]]+name = "pytest"+version = "9.0.2"+source = { registry = "https://pypi.org/simple" }+dependencies = [+ { name = "colorama", marker = "sys_platform == 'win32'" },+ { name = "iniconfig" },+ { name = "packaging" },+ { name = "pluggy" },+ { name = "pygments" },+]+sdist = { url = "https://files.pythonhosted.org/packages/d1/db/7ef3487e0fb0049ddb5ce41d3a49c235bf9ad299b6a25d5780a89f19230f/pytest-9.0.2.tar.gz", hash = "sha256:75186651a92bd89611d1d9fc20f0b4345fd827c41ccd5c299a868a05d70edf11", size = 1568901, upload-time = "2025-12-06T21:30:51.014Z" }+wheels = [+ { url = "https://files.pythonhosted.org/packages/3b/ab/b3226f0bd7cdcf710fbede2b3548584366da3b19b5021e74f5bde2a8fa3f/pytest-9.0.2-py3-none-any.whl", hash = "sha256:711ffd45bf766d5264d487b917733b453d917afd2b0ad65223959f59089f875b", size = 374801, upload-time = "2025-12-06T21:30:49.154Z" },+]+[[package]]name = "python-bidi"version = "0.6.7"diff --git a/ocr/paddleocr/Dockerfile b/ocr/paddleocr/Dockerfileindex c791872..5b08e4a 100644--- a/ocr/paddleocr/Dockerfile+++ b/ocr/paddleocr/Dockerfile@@ -1,4 +1,4 @@-FROM --platform=linux/amd64 ghcr.io/astral-sh/uv:python3.12-trixie+FROM ghcr.io/astral-sh/uv:python3.12-trixie# Install system dependenciesRUN apt-get update && apt-get install -y \diff --git a/ocr/paddleocr/README.md b/ocr/paddleocr/README.mdindex 495d48d..db12306 100644--- a/ocr/paddleocr/README.md+++ b/ocr/paddleocr/README.md@@ -6,18 +6,20 @@ PaddleOCR is especially fast and accurate for Chinese, Japanese, and Korean lang## Build and Run-**With uv (recommended)**+**With uv**```bash# install and run (in one command)uv run python3 server.py```-**With Docker (unstable)**+**With Docker**++> _The Docker build might be unstable or not working depending on the target platform for building the image and running the container (there are known issues with `linux/amd64`)_```bash# Build Docker image-docker build --platform linux/amd64 -t liteparse-paddleocr .+docker build -t liteparse-paddleocr .# Run containerdocker run -p 8829:8829 liteparse-paddleocr@@ -108,6 +110,14 @@ const parser = new LiteParse({const result = await parser.parse('document.pdf');```+## Testing++If you make changes to the server, make sure to adapt and run tests:++```bash+uv run pytest test_server.py+```+## GPU SupportFor GPU acceleration, modify the Dockerfile to use a CUDA base image and set `use_gpu=True` in `server.py`.diff --git a/ocr/paddleocr/pyproject.toml b/ocr/paddleocr/pyproject.tomlindex ccf897b..20d5b62 100644--- a/ocr/paddleocr/pyproject.toml+++ b/ocr/paddleocr/pyproject.toml@@ -24,5 +24,6 @@ explicit = true[dependency-groups]dev = [+ "httpx>=0.28.1","pytest>=9.0.2",]diff --git a/ocr/paddleocr/server.py b/ocr/paddleocr/server.pyindex 109271a..acbda14 100644--- a/ocr/paddleocr/server.py+++ b/ocr/paddleocr/server.py@@ -11,24 +11,6 @@ from paddleocr import PaddleOCRfrom PIL import Imagefrom pydantic import BaseModel-LANGUAGE_MAP = {- "en": "en",- "zh": "ch",- "zh-cn": "ch",- "zh-hans": "ch",- "zh-tw": "chinese_cht",- "zh-hant": "chinese_cht",- "ja": "japan",- "ko": "korean",- "fr": "french",- "de": "german",- "es": "spanish",- "pt": "portuguese",- "ru": "russian",- "ar": "arabic",- "hi": "devanagari",-}-class OcrResponse(BaseModel):results: list[Any]@@ -59,14 +41,13 @@ class PaddleOCRServer:) -> OcrResponse:# Get language from requestlanguage = language.lower()- paddle_lang = LANGUAGE_MAP.get(language, "en")try:# Initialize OCR if needed or language changed- if self.current_language != paddle_lang:+ if self.current_language != language:# PaddleOCR 3.x parametersself.ocr = PaddleOCR(- lang=paddle_lang,+ lang=language,use_doc_orientation_classify=False,use_doc_unwarping=False,use_textline_orientation=True,@@ -87,6 +68,10 @@ class PaddleOCRServer:# PaddleOCR 3.x returns: list of result dicts# Each result has: res['rec_texts'], res['rec_scores'], res['rec_boxes']results = self.ocr.predict(image_array)+ except ValueError as ve:+ if "No models are available for the language" in str(ve):+ raise HTTPException(status_code=400, detail=str(ve))+ raise HTTPException(status_code=500, detail=str(ve))except Exception as e:raise HTTPException(status_code=500, detail=str(e))