# 📚 Reference Scripts

Эта папка содержит оригинальные скрипты конвертации для локального использования.

## 📂 Скрипты

### 1. `convert_to_diffusers.py`
**Назначение**: Конвертация safetensors в Diffusers формат

**Использование**:
```bash
# Отредактируйте параметры в скрипте:
SAFETENSORS_PATH = "path/to/model.safetensors"
BASE_MODEL = "Qwen/Qwen-Image"
OUTPUT_DIR = "./output"

# Запустите:
python convert_to_diffusers.py
```

**Что делает**:
- Загружает базовую модель Qwen-Image
- Загружает веса из safetensors
- Объединяет в Diffusers pipeline
- Сохраняет в указанную папку

---

### 2. `download_and_pack_model.py`
**Назначение**: Скачивание модели с HF и упаковка

**Использование**:
```bash
python download_and_pack_model.py
```

**Что делает**:
- Скачивает VAE, Text Encoder, Tokenizer, Scheduler от базовой модели
- Скачивает кастомный Transformer safetensors
- Упаковывает всё в Diffusers структуру
- Создает .gitattributes для LFS

---

### 3. `upload_model_hf_cli.py`
**Назначение**: Загрузка модели на HuggingFace через API

**Использование**:
```bash
# Отредактируйте параметры:
MODEL_REPO = "YourUsername/Model-Diffusers"
LOCAL_MODEL_DIR = "path/to/model"

# Запустите:
python upload_model_hf_cli.py
```

**Что делает**:
- Создает Model репозиторий на HF
- Загружает всю папку модели через HF API
- Поддерживает resumable uploads
- Показывает прогресс

---

## 🆚 Различия с Gradio Space

| Параметр | Reference Scripts | Gradio Space |
|----------|------------------|--------------|
| **Интерфейс** | Командная строка | Web UI |
| **Где работает** | Локально | В облаке HF |
| **Скачивание** | На ваш компьютер | В Space |
| **Использование** | Ручное | Автоматическое |
| **API** | Нет | Да |

**Рекомендация**: 
- Используйте **Gradio Space** для автоматизации
- Используйте **Reference Scripts** для локальной работы или отладки

---

## 💡 Когда использовать Reference Scripts

### ✅ Используйте Reference Scripts если:
- Хотите контролировать каждый шаг вручную
- Нужно отладить конвертацию
- Работаете с очень большими моделями (100GB+)
- Нестабильный интернет (resumable downloads)

### ✅ Используйте Gradio Space если:
- Хотите автоматизировать процесс
- Не хотите занимать локальное место
- Нужен API доступ
- Хотите удобный интерфейс

---

## 📝 Примечания

- Все скрипты используют HuggingFace API
- Требуется HF Token с write доступом
- Модели скачиваются в локальные папки
- Для больших файлов используется Git LFS