pdf-ocr-installer

Automates PDF-OCR environment setup with Python 3.11, uv, and PP-OCRv5 models.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/ghjghjghkimo/skills --skill pdf-ocr-installer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pdf-ocr-installer
Source: https://github.com/ghjghjghkimo/skills/tree/main/.gemini/skills/pdf-ocr-installer
Command: npx skills add https://github.com/ghjghjghkimo/skills --skill pdf-ocr-installer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires uv, huggingface-hub, pyyaml, and includes scripts (resource) components.

What problem does it solve?

本 Skill 專門用於全自動化配置 PDF-OCR 環境,包含建立虛擬環境、下載模型與生成字典檔。

Core Features & Use Cases

  • 自動建立並配置 Python 3.11 虛擬環境。
  • 自動化從 Hugging Face 下載 PP-OCRv5 模型,準備推理檔案。
  • 從 YAML 取字元字典,輸出成 ppocr_keys_v1.txt,支援快速建置 OCR 流程。
  • Use Case: 團隊可在新機器上快速複製完整的 PDF-OCR 環境,僅需執行安裝腳本。

Quick Start

Run the installer to fully configure the PDF-OCR environment.

Frequently Asked Questions about pdf-ocr-installer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate setting up a PDF-OCR environment from scratch on a new machine?

To automate setting up a PDF-OCR environment, you can run an installer script that uses uv to create a Python 3.11 virtual environment, downloads PP-OCRv5 models from Hugging Face, and generates the required dictionary file. This fully provisions dependencies and configures CUDA-enabled PyTorch if available.

How do I generate the ppocr_keys_v1.txt dictionary file from a YAML configuration?

You can generate the ppocr_keys_v1.txt dictionary file by extracting character definitions from a YAML configuration. The automated setup process parses the YAML file and outputs the ready-to-use dictionary file required for your OCR pipelines.

Can I use uv to provision a Python 3.11 virtual environment for Hugging Face OCR models?

Yes, you can use uv to provision a Python 3.11 virtual environment for Hugging Face OCR models. The setup process specifically uses uv to create the virtual environment and huggingface-hub to download the PP-OCRv5 models automatically.

Does the PDF-OCR setup script configure CUDA-enabled PyTorch automatically?

Yes, the PDF-OCR setup script configures CUDA-enabled PyTorch automatically. During the environment provisioning process, it detects and installs CUDA-enabled PyTorch if available to ensure the OCR pipeline is ready for inference.

What is the best way to reproduce a CI-like PDF-OCR build with PP-OCRv5 models?

The best way to reproduce a CI-like PDF-OCR build with PP-OCRv5 models is to execute an automated installer script. It handles end-to-end workflows by creating the virtual environment with uv, downloading models from Hugging Face, and generating the dictionary file.

Why do I need a ppocr_keys_v1.txt dictionary file for my OCR pipeline?

You need a ppocr_keys_v1.txt dictionary file for your OCR pipeline because it provides the character mappings required by the PP-OCRv5 models during inference. The setup script generates this file from a YAML configuration to ensure accurate text recognition.