Add Python-binding

[t41372]

概述

用 PyO3 和 maturin 做个 python binding，让 Python 开发者也能轻松用这个项目调用这些 ocr，不用去头疼环境配置的问题。

优点

• 让 python 开发者也爽，直接 pip install 就能开始用，而且有 type annotation 开发起来会很舒适。

缺点

• 添加维护成本
• python 开发者其实用 openai 格式的 api 也能调用

poc (晚点细看+测试)

我让 codex 在我自己的 fork 里面尝试实现了一下，看看方案是否可行。

t41372#1

我晚点会再检查一下 AI 的实现。如果合适，可能可以在原项目这边开一个 pr。

相关讨论

https://linux.do/t/topic/1152112/31

[t41372]

状态更新: 基本完工

• 分支: https://github.com/t41372/deepseek-ocr.rs/tree/feat/add-python-binding/bindings/python
• 之前的 poc pr 被扔掉了。
• 单元测试，端到端测试，文档都好了。(不过端到端太大了，所以要特别启动才会测端到端)
• 案例代码也写好了。CPU 的版本可以跑通了。GPU 和其他硬件加速还没实际测试过，但估计问题不大。

这东西现在已经能用了，可以直接 pip 从我的工作分支的代码安装。

# CPU
pip install "git+https://github.com/t41372/deepseek-ocr.rs.git@feat/add-python-binding#subdirectory=bindings/python"

# Example: macOS Metal + Accelerate
MATURIN_NO_DEFAULT_FEATURES=1 \
MATURIN_FEATURES="deepseek-ocr-core/metal,deepseek-ocr-core/accelerate,deepseek-ocr-infer-deepseek/metal,deepseek-ocr-infer-deepseek/accelerate,deepseek-ocr-infer-paddleocr/metal,deepseek-ocr-infer-paddleocr/accelerate,deepseek-ocr-infer-dots/metal,deepseek-ocr-infer-dots/accelerate" \
pip install "git+https://github.com/t41372/deepseek-ocr.rs.git@feat/add-python-binding#subdirectory=bindings/python"

# Example: NVIDIA CUDA (Linux/Windows, requires CUDA 12.x)
MATURIN_NO_DEFAULT_FEATURES=1 \
MATURIN_FEATURES="deepseek-ocr-core/cuda,deepseek-ocr-infer-deepseek/cuda,deepseek-ocr-infer-paddleocr/cuda,deepseek-ocr-infer-dots/cuda" \
pip install "git+https://github.com/t41372/deepseek-ocr.rs.git@feat/add-python-binding#subdirectory=bindings/python"

案例代码在这里

• https://github.com/t41372/deepseek-ocr.rs/tree/feat/add-python-binding/bindings/python/examples
• 包一装，代码里写的图片一换就能跑了。

晚点等明天把案例代码测试好了，确认硬件加速都能用，我就开个 draft pr 到这边来。不过现在先去睡觉了。还有些不同 GPU 的打包问题可以再加强。
如果真的最后打算合并，我们还可以看看要不要丢到 pypi 上面去。