silicon-paddle-ocr
OCR skill using PaddleOCR model via SiliconFlow API. This skill should be used when the user asks to "recognize text from an image", "extract text from a photo", "OCR this image", "read text from screenshot", or mentions "PaddleOCR", "image text recognition", "text extraction from images".
By aotenjou · 1,229 installs
npx skills add aotenjou/silicon-paddleocr --skill silicon-paddle-ocr
Source repository · Upstream listing
OCR Image Text Recognition
Use PaddleOCR to extract text content from images. Supports single image or batch processing.
Overview
This skill provides optical character recognition (OCR) capabilities using the PaddlePaddle/PaddleOCR VL 1.5 model via the SiliconFlow API. Extract text from JPG, PNG, WebP, BMP, and GIF images.
When to Use
Invoke this skill when:
User wants to extract text from an image
User asks to OCR a screenshot or photo
User needs to read text from an image file
User mentions text recognition from images
How to Use
Prerequisites
Ensure the SILICONFLOW API KEY environment variable is set:
Basic Usage
Execute the OCR script:
Arguments
Argument Description
images Image file path(s) or glob pattern (required)
k, api key API key (default: from SILICONFLOW API KEY env)
m, model OCR model name (default: PaddlePaddle/PaddleOCR VL 1.5)
p, prompt Recognition prompt for custom behavior
j, json Output results in JSON format
o, output Save results to specified file
max tokens Maximum tokens in response (default: 2000)
Examples
Single image:
Multiple images with glob:
JSON output format:
Custom prompt for table extraction:
Save to file:
Output Format
Text output (default):
JSON output :
Coordinates Explanation:
LOC values are normalized coordinates converted to pixel coordinates
Conversion: pixel = LOC × (image size / LOC max value)
LOC max value is approximately 972 (may vary by model/image)
The box field provides the four corner coordinates of each text region in pixel format
Supported Image Formats
JPG/JPEG
PNG
WebP
BMP
GIF
Error Handling
If processing fails:
Check that the image file exists
Verify the SILICONFLOW API KEY is valid
Ensure the API endpoint is reachable
Images that fail to process will show an error message, and other images will continue processing.
Additional Resources
Reference Files
references/api configuration.md API configuration details
Example Files
examples/sample usage.sh Example usage script
Scripts
scripts/ocr skill.py The main OCR implementation