# 只安装基础 OCR 能力（含通用 OCR 与文档图像预处理）
python -m pip install paddleocr

# 安装全部可选能力：文档解析、信息抽取、文档翻译等
python -m pip install "paddleocr[all]"

# 国内网络可追加清华镜像源加速（对 paddleocr 及其常规依赖生效）
python -m pip install paddleocr -i https://pypi.tuna.tsinghua.edu.cn/simple

python -m pip install "paddleocr@git+https://github.com/PaddlePaddle/PaddleOCR.git"

python -m pip install paddlepaddle==3.2.0 -i https://www.paddlepaddle.org.cn/packages/stable/cpu/

# CUDA 11.8 轮子，要求显卡驱动 ≥ 450.80.02（Linux）或 ≥ 452.39（Windows）
python -m pip install paddlepaddle-gpu==3.2.0 -i https://www.paddlepaddle.org.cn/packages/stable/cu118/

# CUDA 12.6 轮子，要求显卡驱动 ≥ 550.54.14（Linux / Windows）
python -m pip install paddlepaddle-gpu==3.2.0 -i https://www.paddlepaddle.org.cn/packages/stable/cu126/

python -c "import paddle; print(paddle.__version__)"
# 输出 3.2.0 即成功

python - <<'EOF'
import paddleocr
print(f"PaddleOCR版本: {paddleocr.__version__}")
import paddle
print(f"Paddle版本: {paddle.__version__}")
print(f"GPU可用: {paddle.is_compiled_with_cuda()}")
print(f"GPU数量: {paddle.device.cuda.device_count()}")
EOF

# 1. 安装 Python 3.9~3.12（Microsoft Store 或 python.org）
# 2. 创建虚拟环境
python -m venv venv
.\venv\Scripts\Activate.ps1
# 3. 安装飞桨 CPU 版
python -m pip install paddlepaddle==3.2.0 -i https://www.paddlepaddle.org.cn/packages/stable/cpu/
# 4. 安装 paddleocr
python -m pip install paddleocr
# 5. 验证
python -c "import paddle; print(paddle.__version__)"
paddleocr ocr -i https://paddle-model-ecology.bj.bcebos.com/paddlex/imgs/demo_image/general_ocr_002.png

# 1. 建议 conda/venv 隔离环境
conda create -n paddleocr python=3.10 -y
conda activate paddleocr

# 2. 安装飞桨（GPU 机器把上一条换成 5.2 节的 GPU 命令）
python -m pip install paddlepaddle==3.2.0 -i https://www.paddlepaddle.org.cn/packages/stable/cpu/

# 3. 安装 paddleocr（按需选 all）
python -m pip install "paddleocr[all]"

# 4.（可选）安装高性能推理依赖
paddleocr install_hpi_deps cpu      # 纯 CPU
paddleocr install_hpi_deps gpu      # NVIDIA GPU（需 TensorRT 8.6.1.6 才能用 TRT 后端）

# 5. 冒烟测试
paddleocr ocr -i https://paddle-model-ecology.bj.bcebos.com/paddlex/imgs/demo_image/general_ocr_002.png \
    --use_doc_orientation_classify False \
    --use_doc_unwarping False \
    --use_textline_orientation False \
    --save_path ./output

# Apple Silicon / Intel 通用
brew install python@3.11
python3.11 -m venv venv && source venv/bin/activate
python -m pip install paddlepaddle==3.2.0 -i https://www.paddlepaddle.org.cn/packages/stable/cpu/
python -m pip install paddleocr
paddleocr ocr -i ./test.png

# CPU 变体
docker run --name paddleocr -v $PWD:/paddle --shm-size=8G --network=host \
  -it ccr-2vdh3abv-pub.cnc.bj.baidubce.com/paddlepaddle/paddle:3.0.0 /bin/bash

# GPU 变体（CUDA 11.8 + cuDNN 8.9 + TensorRT 8.6），驱动 ≥ 450.80.02
docker run --gpus all --name paddleocr -v $PWD:/paddle --shm-size=8G --network=host \
  -it ccr-2vdh3abv-pub.cnc.bj.baidubce.com/paddlepaddle/paddle:3.0.0-gpu-cuda11.8-cudnn8.9-trt8.6 /bin/bash

# GPU 变体（CUDA 12.6 + cuDNN 9.5 + TensorRT 10.5），驱动 ≥ 550.54.14
docker run --gpus all --name paddleocr -v $PWD:/paddle --shm-size=8G --network=host \
  -it ccr-2vdh3abv-pub.cnc.bj.baidubce.com/paddlepaddle/paddle:3.0.0-gpu-cuda12.6-cudnn9.5-trt10.5 /bin/bash

# CPU
ccr-2vdh3abv-pub.cnc.bj.baidubce.com/paddlex/paddlex:paddlex3.0.1-paddlepaddle3.0.0-cpu
# GPU CUDA 11.8
ccr-2vdh3abv-pub.cnc.bj.baidubce.com/paddlex/paddlex:paddlex3.0.1-paddlepaddle3.0.0-gpu-cuda11.8-cudnn8.9-trt8.6
# GPU CUDA 12.6（注意：该组合的高性能推理目前仅支持 OpenVINO / ONNX Runtime 后端，暂不支持 TensorRT）
ccr-2vdh3abv-pub.cnc.bj.baidubce.com/paddlex/paddlex:paddlex3.0.1-paddlepaddle3.0.0-gpu-cuda12.6-cudnn9.5-trt10.5

git clone --depth 1 https://github.com/PaddlePaddle/PaddleOCR.git
cd PaddleOCR
# 需要完整提交历史时：git fetch --unshallow
# 需要固定版本时：git clone --depth 1 --branch release/3.5 https://github.com/PaddlePaddle/PaddleOCR.git PaddleOCR-3.5
python -m pip install -r requirements.txt

from paddleocr import PaddleOCR
pipeline = PaddleOCR()
pipeline.export_paddlex_config_to_yaml("PaddleOCR.yaml")

# 或通过 PaddleX CLI 获取官方默认配置
paddlex --get_pipeline_config OCR

pipeline_name: OCR        # PaddleX 产线注册名：通用 OCR 为 OCR
SubModules:
  TextDetection:          # 文本检测子模块
    model_name: PP-OCRv6_medium_det   # 模型名；换模型时必须同步修改
    model_dir: null       # 本地模型权重目录；null 表示自动下载官方模型
    limit_side_len: 64    # 输入边长限制
    limit_type: min       # min/max 两种限制方式
    thresh: 0.3           # 像素阈值
    box_thresh: 0.6       # 框阈值
    unclip_ratio: 1.5     # 扩张系数
    max_side_limit: 4000  # 最大边长上限
    # 也可为单个子模块单独指定推理引擎（优先级高于全局）
    engine: paddle_static
    engine_config:
      device_type: cpu
      cpu_threads: 4
      run_mode: mkldnn    # 可选 paddle / trt_fp32 / trt_fp16 / mkldnn
  TextLineOrientation:    # 文本行方向分类子模块
    model_name: PP-LCNet_x1_0_textline_ori
    model_dir: null
    batch_size: 6
    module_name: textline_orientation
  TextRecognition:        # 文本识别子模块
    model_name: PP-OCRv6_medium_rec
    model_dir: null
    batch_size: 6
    score_thresh: 0.0     # 识别得分过滤阈值
    module_name: text_recognition
# 服务化部署相关（仅 paddlex --serve 时生效）
Serving:
  return_urls: false      # true 时以预签名 URL 返回二进制内容（当前仅支持百度 BOS 对象存储）
  extra:
    max_num_input_imgs: null   # 解除 PDF 默认 10 页限制

paddleocr ocr --paddlex_config PaddleOCR.yaml -i ./test.png

from paddleocr import PaddleOCR
pipeline = PaddleOCR(paddlex_config="PaddleOCR.yaml")

# CLI 单次推理
paddleocr ocr -i ./test.png --save_path ./output

# HTTP 服务（基于 PaddleX 服务化插件）
paddlex --install serving          # 首次需安装 serving 插件
paddlex --serve --pipeline OCR     # 默认监听 0.0.0.0:8080

# /etc/systemd/system/paddleocr-serving.service
[Unit]
Description=PaddleOCR HTTP Serving
After=network.target

[Service]
Type=simple
User=www-data
WorkingDirectory=/opt/paddleocr
# 建议写虚拟环境内绝对路径
ExecStart=/opt/paddleocr/venv/bin/paddlex --serve --pipeline OCR --port 8080
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now paddleocr-serving
sudo systemctl status paddleocr-serving

; /etc/supervisor/conf.d/paddleocr.conf
[program:paddleocr]
command=/opt/paddleocr/venv/bin/paddlex --serve --pipeline OCR --port 8080
directory=/opt/paddleocr
autostart=true
autorestart=true
stdout_logfile=/var/log/paddleocr.log
stderr_logfile=/var/log/paddleocr.err.log

# 方式一：计划任务开机启动（以管理员 PowerShell 运行）
schtasks /create /tn "PaddleOCR" /tr "C:\paddleocr\venv\Scripts\paddlex.exe --serve --pipeline OCR" /sc onstart /ru SYSTEM

# 方式二：NSSM 注册为 Windows 服务
nssm install PaddleOCR "C:\paddleocr\venv\Scripts\paddlex.exe" "--serve --pipeline OCR"
nssm set PaddleOCR AppDirectory C:\paddleocr
nssm start PaddleOCR

# docker-compose.yml
services:
  paddleocr:
    image: ccr-2vdh3abv-pub.cnc.bj.baidubce.com/paddlepaddle/paddle:3.0.0-gpu-cuda12.6-cudnn9.5-trt10.5
    restart: unless-stopped
    shm_size: 8g
    working_dir: /paddle
    volumes:
      - ./workspace:/paddle
    command: >
      bash -lc "pip install paddleocr && paddlex --serve --pipeline OCR --port 8080"
    ports:
      - "8080:8080"
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: all
              capabilities: [gpu]

docker compose up -d

paddlex --serve --pipeline OCR --host 127.0.0.1 --port 9000

server {
    listen 80;
    server_name ocr.example.com;
    location / {
        proxy_pass http://127.0.0.1:9000;
        proxy_set_header Host $host;
        client_max_body_size 50m;   # 请求体含 Base64 图片，需放宽体积
    }
}

# 下载官方示例图
wget https://paddle-model-ecology.bj.bcebos.com/paddlex/imgs/demo_image/general_ocr_002.png

paddleocr ocr -i ./general_ocr_002.png \
    --use_doc_orientation_classify False \
    --use_doc_unwarping False \
    --use_textline_orientation False \
    --save_path ./output

from paddleocr import PaddleOCR

ocr = PaddleOCR(
    use_doc_orientation_classify=False,  # 不使用文档方向分类
    use_doc_unwarping=False,             # 不使用文本图像矫正
    use_textline_orientation=False,      # 不使用文本行方向分类
)
# 常用变体：
# ocr = PaddleOCR(lang="en")                    # 英文模型
# ocr = PaddleOCR(ocr_version="PP-OCRv5")       # 切换到 PP-OCRv5
# ocr = PaddleOCR(device="gpu")                 # 使用 GPU
# ocr = PaddleOCR(
#     text_detection_model_name="PP-OCRv5_server_det",
#     text_recognition_model_name="PP-OCRv5_server_rec",
# )                                             # 指定 server 级模型

result = ocr.predict("./general_ocr_002.png")
for res in result:
    res.print()                    # 打印结果
    res.save_to_img("output")      # 保存可视化图
    res.save_to_json("output")     # 保存 JSON

pip install "transformers>=5.10.0"   # 或 pip install onnxruntime-gpu

paddleocr ocr -i ./general_ocr_002.png --engine transformers
paddleocr ocr -i ./general_ocr_002.png --engine onnxruntime

from paddleocr import PaddleOCR
ocr = PaddleOCR(engine="onnxruntime", use_doc_orientation_classify=False,
                use_doc_unwarping=False, use_textline_orientation=False)
result = ocr.predict("./general_ocr_002.png")

from pathlib import Path
from paddleocr import PPStructureV3

pipeline = PPStructureV3()
output = pipeline.predict("./your_pdf_file.pdf")

markdown_list = []
markdown_images = []
for res in output:
    res.print()
    res.save_to_json(save_path="output")
    res.save_to_markdown(save_path="output")   # 每页一个 Markdown
    res.save_to_word(save_path="output")       # 3.5+ 支持导出 DOCX

paddleocr pp_structurev3 -i ./pp_structure_v3_demo.png --device gpu

curl -X POST http://127.0.0.1:8080/ocr \
  -H "Content-Type: application/json" \
  -d '{"file": "https://paddle-model-ecology.bj.bcebos.com/paddlex/imgs/demo_image/general_ocr_002.png", "fileType": 1}'

# 1) 启用高性能推理
paddleocr install_hpi_deps gpu
paddleocr ocr -i ./test.png --enable_hpi True

# 2) 半精度 + TensorRT（CUDA 11.8 + TensorRT 8.6.1.6）
paddleocr ocr -i ./test.png --use_tensorrt True --precision fp16

# 3) 多卡并行
paddleocr ocr -i ./images_dir/ --device 'gpu:0,1,2,3'

import os
os.environ["PADDLE_PDX_PIPELINE_BENCHMARK"] = "True"   # 必须在 import 前设置

from paddleocr import PaddleOCR, benchmark
pipeline = PaddleOCR()
benchmark.start_warmup()
for _ in range(50):
    pipeline.predict("./general_ocr_002.png")
benchmark.stop_warmup()
for _ in range(100):
    pipeline.predict("./general_ocr_002.png")
benchmark.print_pipeline_data()          # 打印逐操作耗时
benchmark.save_pipeline_data("./benchmark")  # 输出 detail.csv / summary.csv

paddleocr ocr -i ./test.png \
  --text_detection_model_name PP-OCRv5_mobile_det \
  --text_detection_model_dir /models/pp-ocrv5_mobile_det \
  --text_recognition_model_dir /models/pp-ocrv5_mobile_rec

from paddleocr import PaddleOCR
pipeline = PaddleOCR(
    text_detection_model_dir="/models/det",
    text_recognition_model_dir="/models/rec",
)

pip show paddleocr | head -2
python -c "import paddleocr; print(paddleocr.__version__)"
python -c "import paddle; print(paddle.__version__)"
paddleocr --help   # CLI 可用即安装成功

pip install -U paddleocr
# 升级飞桨（先看版本对应表）
pip install -U paddlepaddle==3.2.0 -i https://www.paddlepaddle.org.cn/packages/stable/cpu/
# 升级后清理旧模型缓存与引擎缓存可避免兼容问题（模型缓存目录由 PaddleX 管理，位置以其文档为准）

pip install "paddleocr==3.5.0"
pip install paddlepaddle==3.0.0 -i https://www.paddlepaddle.org.cn/packages/stable/cpu/

docker pull ccr-2vdh3abv-pub.cnc.bj.baidubce.com/paddlepaddle/paddle:3.0.0-gpu-cuda12.6-cudnn9.5-trt10.5
# 回滚：直接改用旧 tag 重建容器
docker stop paddleocr && docker rm paddleocr
docker run --gpus all --name paddleocr ... # 换回旧镜像 tag

# 1. 卸载 Python 包
pip uninstall -y paddleocr paddlex paddlepaddle paddlepaddle-gpu

# 2. 停止并删除服务
sudo systemctl disable --now paddleocr-serving
sudo rm /etc/systemd/system/paddleocr-serving.service && sudo systemctl daemon-reload
# supervisor: supervisorctl stop paddleocr && supervisorctl remove paddleocr
# nssm: nssm stop PaddleOCR && nssm remove PaddleOCR confirm

# 3. 删除容器与镜像
docker rm -f paddleocr
docker rmi ccr-2vdh3abv-pub.cnc.bj.baidubce.com/paddlepaddle/paddle:3.0.0

# 4. 删除虚拟环境与工作目录
rm -rf ~/miniconda3/envs/paddleocr /opt/paddleocr

# 5. 删除模型缓存（位置以 PaddleX 文档为准，通常在用户主目录下的 paddlex 隐藏目录）
rm -rf ~/.paddlex

# 6. 删除结果输出与配置
rm -rf ./output ./PaddleOCR.yaml

# 安装
pip install paddleocr                                  # 基础版
pip install "paddleocr[all]"                           # 全功能
python -m pip install paddlepaddle==3.2.0 -i https://www.paddlepaddle.org.cn/packages/stable/cpu/   # 飞桨 CPU
python -m pip install paddlepaddle-gpu==3.2.0 -i https://www.paddlepaddle.org.cn/packages/stable/cu126/  # 飞桨 GPU
paddleocr install_hpi_deps cpu|gpu                     # 高性能推理依赖

# 推理
paddleocr ocr -i img.png                               # 最简 OCR
paddleocr ocr -i img.png --device gpu:0 --save_path ./output
paddleocr ocr -i img.png --ocr_version PP-OCRv5 --lang en
paddleocr ocr -i img.png --enable_hpi True
paddleocr pp_structurev3 -i doc.pdf                    # PDF 转 Markdown
paddleocr text_detection -i img.png                    # 单模块

# 服务化
paddlex --install serving
paddlex --serve --pipeline OCR --port 8080
curl -X POST http://127.0.0.1:8080/ocr -H "Content-Type: application/json" -d '{"file":"<URL或Base64>","fileType":1}'

# 配置与调优
paddlex --get_pipeline_config OCR                      # 获取产线 YAML
paddleocr ocr --paddlex_config PaddleOCR.yaml -i img.png
PADDLE_PDX_PIPELINE_BENCHMARK=True python bench.py     # 逐层耗时

# 环境验证
python -c "import paddle; print(paddle.__version__)"
python -c "import paddleocr; print(paddleocr.__version__)"