Upload README.md with huggingface_hub

README.md

@@ -1,12 +1,251 @@
----
-title: Qwen Model Converter
-emoji: 🚀
-colorFrom: green
-colorTo: indigo
-sdk: gradio
-sdk_version: 5.49.1
-app_file: app.py
-pinned: false
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+---
+title: Qwen Model Converter
+emoji: 🔄
+colorFrom: green
+colorTo: blue
+sdk: gradio
+sdk_version: "5.9.1"
+app_file: app.py
+pinned: false
+license: apache-2.0
+tags:
+  - model-conversion
+  - diffusers
+  - qwen
+  - safetensors
+  - automation
+short_description: Convert Qwen models from safetensors to Diffusers
+---
+
+# 🔄 Qwen Model Converter
+
+**Автоматическая конвертация моделей** из safetensors в Diffusers формат с загрузкой на HuggingFace.
+
+## 🎯 Что делает этот Space
+
+### Полный автоматический пайплайн:
+
+1. **📥 Скачивание** safetensors модели с HuggingFace (по приватному токену)
+2. **📥 Скачивание** базовой модели для компонентов (VAE, Text Encoder, Tokenizer)
+3. **🔄 Конвертация** в Diffusers формат с упаковкой всех компонентов
+4. **📤 Загрузка** готовой модели обратно на HuggingFace
+
+**Всё происходит автоматически в облаке!**
+
+---
+
+## ✨ Особенности
+
+- ✅ **Полностью автоматизирован** - нужно только указать параметры
+- ✅ **Работает в облаке** - не нужно скачивать 40GB+ локально
+- ✅ **Поддержка больших моделей** - 40GB+ safetensors файлы
+- ✅ **Resumable uploads** - продолжает загрузку после прерывания
+- ✅ **Подробные логи** - отслеживание каждого этапа
+- ✅ **API доступ** - можно использовать программно
+
+---
+
+## 🚀 Использование
+
+### Web UI
+
+1. Откройте Space: https://huggingface.co/spaces/Gerchegg/Qwen-Model-Converter
+2. Заполните форму:
+   - **Source Repo** - репозиторий с safetensors файлом
+   - **Source File** - имя safetensors файла
+   - **Base Model** - базовая модель (обычно `Qwen/Qwen-Image`)
+   - **Target Repo** - куда загрузить результат
+   - **HF Token** - ваш токен с write доступом
+3. Нажмите **"Запустить конвертацию"**
+4. Дождитесь завершения (45-90 минут)
+
+### API
+
+```python
+from gradio_client import Client
+
+client = Client("Gerchegg/Qwen-Model-Converter")
+
+result = client.predict(
+    source_repo_id="Gerchegg/QwenSolobandModel",
+    source_filename="Qwen_Soloband_Model_V1-000140.safetensors",
+    base_model_id="Qwen/Qwen-Image",
+    target_repo_id="YourUsername/Your-Model-Diffusers",
+    hf_token="hf_your_token_here",
+    api_name="/convert"
+)
+
+status, logs = result
+print(status)  # "✅ Готово! URL: https://..."
+```
+
+---
+
+## 📋 Требования
+
+### HuggingFace Token
+
+Нужен токен с правами:
+- ✅ **Read** - для скачивания source модели
+- ✅ **Write** - для создания target репозитория
+
+Получить токен: https://huggingface.co/settings/tokens
+
+### Source Model
+
+- Формат: **safetensors** (один файл или папка)
+- Архитектура: **Qwen-Image DiT** (или совместимая)
+- Размер: любой (поддерживаются файлы 40GB+)
+
+### Base Model
+
+- Обычно: `Qwen/Qwen-Image`
+- Должна содержать компоненты: VAE, Text Encoder, Tokenizer, Scheduler
+
+---
+
+## 💡 Примеры
+
+### Пример 1: Конвертация Qwen Soloband
+
+```
+Source Repo: Gerchegg/QwenSolobandModel
+Source File: Qwen_Soloband_Model_V1-000140.safetensors
+Base Model: Qwen/Qwen-Image
+Target Repo: YourUsername/Qwen-Soloband-Diffusers
+```
+
+**Результат**: Готовая Diffusers модель (~58GB)
+
+### Пример 2: Конвертация кастомной LoRA
+
+```
+Source Repo: Username/CustomLoRAModel
+Source File: custom_lora.safetensors
+Base Model: Qwen/Qwen-Image
+Target Repo: Username/CustomLoRA-Diffusers
+```
+
+---
+
+## 📊 Процесс конвертации
+
+### Что происходит внутри:
+
+```
+[1/4] Скачивание safetensors (~40GB)
+  ├─ Скачивает кастомные веса модели
+  └─ Время: 5-10 минут
+
+[2/4] Скачивание базовой модели (~18GB)
+  ├─ Скачивает VAE, Text Encoder, Tokenizer, Scheduler
+  └─ Время: 5-10 минут
+
+[3/4] Конвертация в Diffusers
+  ├─ Создает структуру папок
+  ├─ Копирует компоненты базовой модели
+  ├─ Добавляет кастомный transformer
+  ├─ Создает config.json
+  └─ Время: 1-2 минуты
+
+[4/4] Загрузка на HuggingFace (~58GB)
+  ├─ Создает Model репозиторий
+  ├─ Загружает все файлы через HF API
+  └─ Время: 30-60 минут
+```
+
+**Общее время**: 45-90 минут
+
+---
+
+## 🔍 Структура результата
+
+После конвертации модель будет иметь структуру:
+
+```
+YourModel-Diffusers/
+├── model_index.json           # Главный конфиг pipeline
+├── vae/                        # VAE encoder/decoder
+│   ├── config.json
+│   └── diffusion_pytorch_model.safetensors
+├── text_encoder/               # Text Encoder (Qwen2)
+│   ├── config.json
+│   ├── model-00001-of-00004.safetensors
+│   ├── model-00002-of-00004.safetensors
+│   ├── model-00003-of-00004.safetensors
+│   └── model-00004-of-00004.safetensors
+├── tokenizer/                  # Tokenizer
+│   ├── tokenizer_config.json
+│   ├── vocab.json
+│   └── merges.txt
+├── scheduler/                  # Noise scheduler
+│   └── scheduler_config.json
+└── transformer/                # Кастомный transformer
+    ├── config.json
+    └── diffusion_pytorch_model.safetensors  # Ваши веса
+```
+
+---
+
+## 💻 Локальное использование
+
+Если хотите запустить локально:
+
+```bash
+git clone https://huggingface.co/spaces/Gerchegg/Qwen-Model-Converter
+cd Qwen-Model-Converter
+pip install -r requirements.txt
+python app.py
+```
+
+---
+
+## 🐛 Troubleshooting
+
+### Проблема: "Invalid HF Token"
+
+**Решение**: 
+- Проверьте что токен начинается с `hf_`
+- Убедитесь что токен имеет права **write** для model repositories
+- Создайте новый токен: https://huggingface.co/settings/tokens
+
+### Проблема: "Out of Memory"
+
+**Решение**:
+- Этот Space работает в облаке HuggingFace
+- Обычно памяти достаточно
+- Если проблема - попробуйте позже
+
+### Проблема: Upload timeout
+
+**Решение**:
+- HF API автоматически возобновляет загрузку
+- Просто подождите или перезапустите
+- Загрузка продолжится с места остановки
+
+### Проблема: "Repository already exists"
+
+**Решение**:
+- Это нормально, модель будет обновлена
+- Или укажите другое имя target repository
+
+---
+
+## 📚 Дополнительная информация
+
+- **Diffusers Documentation**: https://huggingface.co/docs/diffusers
+- **HuggingFace Hub**: https://huggingface.co/docs/hub
+- **Qwen-Image**: https://huggingface.co/Qwen/Qwen-Image
+
+---
+
+## 📝 License
+
+Apache 2.0
+
+## 🤝 Credits
+
+- Qwen Team за базовую модель
+- Diffusers Team за библиотеку
+- HuggingFace за инфраструктуру
+