安装

Warning

rapidocr_onnxruntime, rapidocr_openvino, rapidocr_paddle 三个库逐渐不再维护，后续会以 rapidocr 为主。

简介¶

rapidocr 是合并了 rapidocr_onnxruntime, rapidocr_openvino, rapidocr_paddle 以及支持 PyTorch 推理的版本。

rapidocr>=2.0.0,<=2.0.5 中，默认采用 ONNX Runtime CPU 版作为推理引擎，可以通过安装其他推理引擎，通过相应参数来使用 GPU 推理。该部分请参见后续文档。

rapidocr>=2.0.6 中不再将 ONNX Runtime 库作为依赖包，但是仍然是默认推理引擎。该版本及以后需要小伙伴们手动安装所需推理引擎来使用。

rapidocr>=3.10.0，默认依赖的 opencv 库由 opencv-python 改为了 opencv-python-headless。推荐使用如下：

服务端、Docker、无桌面环境：使用 opencv-python-headless，也就是直接安装就可以了。

需要 imshow、窗口显示等 GUI 功能：改装 opencv-python。两者不要同时安装，避免 cv2 冲突。

pip uninstall opencv-python-headless
pip install opencv-python

安装¶

顺利的话，一行命令即可使用上。rapidocr 包大小约为 27.2M 左右，包含三个模型：文本检测、文本行方向分类和文本识别。其中 small 版模型较小，因此将相关模型都已打到 whl 包，可直接 pip 安装使用。

pip install rapidocr onnxruntime

国内安装速度慢的话，可以指定国内的安装源，如使用清华源：

pip install rapidocr -i https://pypi.tuna.tsinghua.edu.cn/simple/

按需安装额外依赖¶

rapidocr>=3.10.0 支持

如果需要使用阿拉伯语等从右向左书写的语言，请安装 RTL 支持：

pip install "rapidocr[rtl]" onnxruntime

如果已经安装了 rapidocr 和推理引擎，只需补充安装：

pip install "rapidocr[rtl]"

rtl extra 会安装 python-bidi，用于调整从右向左语言的显示顺序。

验证安装是否成功¶

rapidocr>=2.0.3 验证方式rapidocr>=2.0.0,<2.0.2 验证方式

$ rapidocr check

# 输出以下内容即证明安装成功
[INFO] 2026-06-23 12:51:43,979 [RapidOCR] base.py:23: Using engine_name: onnxruntime
[INFO] 2026-06-23 12:51:44,045 [RapidOCR] download_file.py:60: File exists and is valid: /usr/local/lib/python3.12/dist-packages/rapidocr/models/PP-OCRv6_det_small.onnx
[INFO] 2026-06-23 12:51:44,046 [RapidOCR] main.py:63: Using /usr/local/lib/python3.12/dist-packages/rapidocr/models/PP-OCRv6_det_small.onnx
[INFO] 2026-06-23 12:51:44,127 [RapidOCR] base.py:23: Using engine_name: onnxruntime
[INFO] 2026-06-23 12:51:44,129 [RapidOCR] download_file.py:60: File exists and is valid: /usr/local/lib/python3.12/dist-packages/rapidocr/models/ch_ppocr_mobile_v2.0_cls_mobile.onnx
[INFO] 2026-06-23 12:51:44,129 [RapidOCR] main.py:63: Using /usr/local/lib/python3.12/dist-packages/rapidocr/models/ch_ppocr_mobile_v2.0_cls_mobile.onnx
[INFO] 2026-06-23 12:51:44,190 [RapidOCR] base.py:23: Using engine_name: onnxruntime
[INFO] 2026-06-23 12:51:44,260 [RapidOCR] download_file.py:60: File exists and is valid: /usr/local/lib/python3.12/dist-packages/rapidocr/models/PP-OCRv6_rec_small.onnx
[INFO] 2026-06-23 12:51:44,260 [RapidOCR] main.py:63: Using /usr/local/lib/python3.12/dist-packages/rapidocr/models/PP-OCRv6_rec_small.onnx
Success! rapidocr is installed correctly!

运行以下代码，终端可以打印出文字内容，即安装成功。

rapidocr -img "https://www.modelscope.cn/models/RapidAI/RapidOCR/resolve/master/resources/test_files/ch_en_num.jpg" --vis_res

Info

如果在安装过程中，出现某个依赖包不能正确安装时，可先单独安装某个依赖包，之后再安装 rapidocr 即可。

依赖的包如下：

pyclipper>=1.2.0
opencv-python-headless>=4.5.1.48
numpy>=1.19.5,<3.0.0
six>=1.15.0
Shapely>=1.7.1,!=2.0.4  # python3.12 2.0.4 bug
PyYAML
Pillow
tqdm
omegaconf!=2.2.1 # https://github.com/omry/omegaconf/issues/934
requests
colorlog

安装

简介¶

安装¶

按需安装额外依赖¶

验证安装是否成功¶

评论