README.md

metadata

title: Wuthering OCR API
emoji: 🔎
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
short_description: OCR API for wuwa.dev

Wuthering OCR Space

FastAPI + PaddleOCR server for the unified Hugging Face Docker Space.

Runtime Endpoints

• GET /health?lang=kr
• GET /wake?lang=kr
• POST /ocr with form-data file and lang

Supported lang values: kr, en, jp, zh.

CI/CD

The repository workflow .github/workflows/deploy-hf-ocr.yml runs lightweight tests for this folder, then uploads this directory to Hugging Face when main passes. Deployment uses Hugging Face Trusted Publishers with GitHub OIDC.

Required GitHub settings:

• Actions variable HF_SPACE_REPO_ID: target Space repo id, for example sharp/wuwa-ocr.

The workflow deploys only this subdirectory:

backend/paddle OCR

Local Checks

python -m pip install -r requirements-ci.txt
python -m py_compile main.py ocr_config.py ocr_engine.py image_processing.py ocr_service.py
pytest