Upload scripts_reference/README.md with huggingface_hub

scripts_reference/README.md

@@ -0,0 +1,104 @@
+# 📚 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
+