Super OCR

Overview

Super OCR is a production-grade optical character recognition tool that intelligently selects the best engine for your needs:

• - Tesseract Engine: Lightweight, fast (~200-500ms), perfect for simple text extraction
• PaddleOCR Engine: High accuracy (98%+), optimized for Chinese, ideal for complex documents

Engine Selection Strategy

Auto Mode (Default)

Force Mode

• - --engine tesseract - Use Tesseract only
• INLINECODE1 - Use PaddleOCR only
• INLINECODE2 - Auto-select (default)

Quick Start

Installation

This skill requires the following dependencies:

• - PaddleOCR (for Chinese text recognition - 98%+ accuracy)
• Tesseract (for fast English text recognition)
• OpenCV (for image preprocessing)

Option 1: Install with pip (all-in-one)

Option 2: Install dependencies manually

macOS:
CODEBLOCK1

Ubuntu/Debian:
CODEBLOCK2

Windows:
CODEBLOCK3

Usage

CODEBLOCK4

Structuring This Skill

This skill uses a capabilities-based structure with multiple execution modes:

1. 1. Engine Selection Logic - Intelligent decision making
2. OCR Execution - Unified interface for different engines
3. Post-processing - Standardized output formatting
4. Validation & Fallback - Quality assurance

Core Capabilities

1. Intelligent Engine Selection

The skill includes a decision tree that analyzes:

• - Image characteristics (contrast, text size)
• Language patterns (Chinese character detection)
• User requirements (speed vs accuracy)

See scripts/engine_selector.py for implementation details.

2. Dual Engine Support

Tesseract Engine (scripts/tesseract_ocr.py):

• - Fast preprocessing pipeline
• PSM mode 6 for uniform text blocks
• Confidence scoring per word
• Language detection

PaddleOCR Engine (scripts/paddle_ocr.py):

• - State-of-art? SN (East text detection)
• Crnn recognition with LSTM
• Confidence scores per character
• Table detection support

3. Output Formats

Supports multiple output formats:

4. Quality Guarantees

• - Confidence thresholds (configurable, default 80%)
• Low-confidence alerts for manual review
• \Fallback processing for failed OCRs

Resources

scripts/

• - main.py - Main entry point, CLI interface (supports multi-engine)
• INLINECODE7 - Auto-install and validation
• INLINECODE8 - Multiple output format support
• INLINECODE9 - OCR engine implementations

• - preprocessing/ - Image preprocessing utilities

dependencies.py (Key Feature)

The dependencies.py module handles:

• - Dependency detection (paddleocr, paddlepaddle, pytesseract, cv2)
• Auto-install on missing dependencies
• version checking
• OS-specific installation commands
• Clear error messages with troubleshooting steps

Use this when setting up a new environment with INLINECODE21

Advanced Features

Custom Configuration

Create config.yaml for persistent settings:

CODEBLOCK5

Batch Processing

Process multiple images:

CODEBLOCK6

API Mode

Use as a Python library:

CODEBLOCK7

Anti-Patterns

• - ❌ Using PaddleOCR for every image (overhead for simple cases)
• ❌ ignoring confidence scores (quality matters)
• ❌ Biases (always prefering one engine)
• ❌ Skipping preprocessing (quality impact)

Performance Notes

Initialize once, reuse processor for batch processing.