README.md

metadata

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)

{
  "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