| --- |
| title: 4K Upscaler Pro |
| emoji: ⬆️ |
| colorFrom: purple |
| colorTo: blue |
| sdk: gradio |
| sdk_version: "5.15.0" |
| python_version: "3.10.13" |
| app_file: app.py |
| pinned: false |
| license: mit |
| --- |
| |
| # ⬆ 4K Upscaler Pro |
|
|
| AI-powered image & video upscaler supporting up to 4K resolution (3840×2160). |
|
|
| ## Features |
| - 🖼 Image upscaling (PNG, JPG, WEBP) |
| - 🎬 Video upscaling (MP4, AVI, MOV) |
| - 🤖 Real-ESRGAN AI upscaling (GPU mode) + Lanczos fallback (CPU) |
| - 📡 Full REST API for n8n, Zapier, or any automation tool |
| - 🎯 Targets: 4K, 2K, 1080p, or 2× original |
|
|
| ## Deployment Guide |
|
|
| ### Step 1: Create Hugging Face Space |
| 1. Go to https://huggingface.co/new-space |
| 2. Name it: `4k-upscaler` |
| 3. SDK: **Gradio** |
| 4. Hardware: **CPU Basic** (free) or **T4 GPU** for Real-ESRGAN |
|
|
| ### Step 2: Upload Files |
| Upload all essential files to your Space: |
| - `app.py` |
| - `core.py` |
| - `requirements.txt` |
| - `pyproject.toml` |
| - `packages.txt` (adds ffmpeg for video rendering) |
| ### Step 3: Get Your API URL |
| Your API will be live at: |
| ``` |
| https://<your-username>-4k-upscaler.hf.space/api/predict |
| ``` |
|
|
| --- |
|
|
| ## n8n Integration |
|
|
| ### Image Upscaling via n8n HTTP Request Node |
|
|
| ``` |
| Method: POST |
| URL: https://<your-username>-4k-upscaler.hf.space/api/predict |
| Headers: |
| Content-Type: application/json |
| Authorization: Bearer <YOUR_HF_TOKEN> (only if Space is private) |
| |
| Body (JSON): |
| { |
| "data": [ |
| "data:image/png;base64,<BASE64_IMAGE>", |
| "Lanczos (Fast)", |
| "4K (3840×2160)" |
| ] |
| } |
| ``` |
|
|
| ### n8n Workflow Steps |
| 1. **Trigger** (e.g., HTTP webhook or file watch) |
| 2. **Read Binary Data** → convert image to base64 |
| 3. **HTTP Request** → POST to HF Space API |
| 4. **Extract Result** → `{{ $json.data[0] }}` = base64 upscaled image |
| 5. **Write File** → save the upscaled image |
|
|
| ### Video Upscaling (fn_index: 1) |
| ```json |
| { |
| "fn_index": 1, |
| "data": [ |
| "<video_url_or_base64>", |
| "Lanczos (Fast)", |
| "4K (3840×2160)" |
| ] |
| } |
| ``` |
| |
| --- |
|
|
| ## API Reference |
|
|
| | Parameter | Values | |
| |-----------|--------| |
| | Method | `Real-ESRGAN (AI)` or `Lanczos (Fast)` | |
| | Target | `4K (3840×2160)`, `2K (2560×1440)`, `1080p (1920×1080)`, `2x Original` | |
|
|
| ## Hardware Recommendation |
| - **CPU (Free):** Lanczos fast upscaling works perfectly |
| - **T4 GPU ($0.60/hr):** Enables Real-ESRGAN AI upscaling for dramatically better quality |
|
|
