name: image-ocr description: "Extract text from images using Tesseract OCR (supports Chinese, English, and other languages)." version: 1.1.0 author: Hermes Agent license: MIT platforms: [windows, macos, linux] metadata: hermes: tags: [OCR, Image, Text-Extraction, Chinese, English, Cross-Platform]

Image OCR (Tesseract)

Extract text from images using Tesseract OCR engine with Python wrapper. Cross-platform support for Windows, macOS, and Linux.

Prerequisites

• Tesseract OCR (v5.0+)
• Python packages: pytesseract, Pillow
• Language packs: Chinese (chi_sim) and English (eng) recommended

Install Tesseract

Install Python Dependencies

pip install pytesseract Pillow

Usage

Basic OCR

python scripts/ocr.py <image_path> [-l LANGUAGE] [--psm PSM]

Examples:

# Auto-detect Tesseract, use default language (chi_sim+eng)
python scripts/ocr.py screenshot.png

# Specify language
python scripts/ocr.py document.jpg -l chi_sim+eng

# Specify page segmentation mode
python scripts/ocr.py photo.jpg -l eng --psm 6

# Specify Tesseract path manually
python scripts/ocr.py image.png --tesseract-path "C:\Program Files\Tesseract-OCR"

# List installed language packs
python scripts/ocr.py --list-langs

Tesseract Discovery (auto-detection order)

The script finds Tesseract automatically in this order:

1. --tesseract-path CLI argument
2. TESSERACT_PATH environment variable
3. Config file (~/.config/image-ocr/config.json or %APPDATA%/image-ocr/config.json)
4. Common install locations:
5. Windows: C:\Program Files\Tesseract-OCR, C:\Program Files (x86)\Tesseract-OCR
6. macOS: /usr/local/bin/tesseract, /opt/homebrew/bin/tesseract
7. Linux: /usr/bin/tesseract, /usr/local/bin/tesseract
8. System PATH

Persistent Configuration

Create a JSON config file to set a persistent Tesseract path:

Windows: %APPDATA%\image-ocr\config.json macOS/Linux: ~/.config/image-ocr/config.json

{
  "tesseract_path": "/path/to/tesseract"
}

Supported Languages

Combine multiple languages: chi_sim+eng

小蔥技能7w4.net有更新，你可以訪問看下。

Script Location

scripts/ocr.py - Main OCR script

Notes

• For best results, ensure images are clear and well-lit
• Chinese recognition requires chi_sim language pack
• Output is plain text; use --psm flag for specific page segmentation modes
• Verbose diagnostic info (Tesseract version, path, language) is printed to stderr

這是一款實用的影像文字識別工具，中文識別效果好，支援多平臺使用。安裝和配置說明詳細，錯誤提示友好。但文件與實際指令碼名稱存在不一致，版本資訊也有出入。對於普通使用者而言功能是可靠的，但使用前需注意閱讀最新文件確認正確的指令碼名稱。