README.md

metadata

title: app
app_file: app.py
sdk: gradio
sdk_version: 5.38.1

🚀 Photo Upscaler - Hugging Face Gradio App

Pokročilá aplikace pro zvětšování fotografií pomocí AI modelů z Hugging Face.

✨ Funkce

• 🔍 AI Upscaling: Používá nejmodernější modely pro zvětšování obrázků
• 🎯 Více modelů: Různé modely pro různé typy obrázků
• 🌐 Hugging Face integrace: Přímé propojení s HF modely
• 🎨 Moderní UI: Přehledné a intuitivní rozhraní
• ⚡ GPU podpora: Automatická detekce CUDA

🛠️ Instalace

1. Klonování a příprava prostředí

# Přejděte do složky projektu
cd gratio

# Vytvořte virtuální prostředí
python -m venv venv

# Aktivace prostředí (Windows)
venv\Scripts\activate

# Aktivace prostředí (macOS/Linux)
source venv/bin/activate

2. Instalace dependencies

pip install -r requirements.txt

3. Spuštění aplikace

python app.py

Aplikace se spustí na http://localhost:7860

🎯 Jak používat

1. Nahrajte obrázek: Přetáhněte nebo vyberte fotografii
2. Nastavte parametry:
   • Faktor zvětšení (1.5x - 4x)
   • Vyberte vhodný model
   • Volitelně zadejte HF token
3. Klikněte na "Zvětšit obrázek"
4. Stáhněte výsledek

🤖 Dostupné modely

• microsoft/swin2SR-compressed-sr-x2-48: Komprimovaný model pro 2x zvětšení
• microsoft/swin2SR-compressed-sr-x4-48: Komprimovaný model pro 4x zvětšení
• caidas/swin2SR-realworld-sr-x4-64-bsrgan-psnr: Nejlepší pro reálné fotografie
• microsoft/swin2SR-classical-sr-x2-64: Pro umělé/digitální obrázky (2x)
• microsoft/swin2SR-classical-sr-x4-64: Pro umělé/digitální obrázky (4x)

🔐 Hugging Face Token

Pro nejlepší výsledky doporučujeme:

1. Registraci na Hugging Face
2. Vytvoření tokenu v nastavení
3. Zadání tokenu do aplikace

💡 Tipy pro nejlepší výsledky

• Velikost obrázku: 256x256 až 512x512 pixelů pro nejlepší rychlost
• Typ obrázku: Volte model podle typu (reálné foto vs. digitální)
• GPU: Pro rychlejší zpracování použijte GPU s CUDA
• Formát: PNG poskytuje nejlepší kvalitu

🚀 Nápady na rozšíření

Základní rozšíření:

• Batch processing: Zpracování více obrázků najednou
• Noise reduction: Odstraňování šumu z obrázků
• Format converter: Konverze mezi různými formáty
• History: Historie zpracovaných obrázků

Pokročilé funkce:

• Custom models: Možnost nahrání vlastních modelů
• API endpoint: RESTful API pro externí integrace
• Cloud storage: Integrace s cloud úložišti
• Real-time preview: Náhled během zpracování

AI vylepšení:

• Style transfer: Přenos stylu na obrázky
• Colorization: Obarvování černobílých fotek
• Face enhancement: Specializované vylepšování obličejů
• HDR processing: Zpracování HDR obrázků

📊 Deployment na Hugging Face Spaces

# Přidejte do app.py na konec:
if __name__ == "__main__":
    demo.launch()

# Vytvořte app.py s touto konfigurací pro HF Spaces

🔧 Troubleshooting

Časté problémy:

Model se nenačte:

• Zkontrolujte internetové připojení
• Ověřte HF token
• Zkuste jiný model

Pomalé zpracování:

• Zmenšete velikost obrázku
• Použijte GPU
• Vyberte komprimovaný model

Chyba paměti:

• Snižte rozlišení vstupního obrázku
• Zavřete ostatní aplikace
• Použijte menší model

📝 Licence

MIT License - můžete svobodně používat a upravovat.

🤝 Přispívání

Máte nápad na vylepšení? Vytvořte issue nebo pošlete pull request!

---

Užijte si zvětšování svých fotografií! 📸✨