app / README.md
Semnykcz's picture
Upload folder using huggingface_hub
7fc1882 verified
---
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í
```bash
# 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
```bash
pip install -r requirements.txt
```
### 3. Spuštění aplikace
```bash
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](https://huggingface.co/)
2. Vytvoření tokenu v [nastavení](https://huggingface.co/settings/tokens)
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
```bash
# 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í! 📸✨**