scripts_reference/README.md

📚 Reference Scripts

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

📂 Скрипты

1. convert_to_diffusers.py

Назначение: Конвертация safetensors в Diffusers формат

Использование:

# Отредактируйте параметры в скрипте:
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 и упаковка

Использование:

python download_and_pack_model.py

Что делает:

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

---

3. upload_model_hf_cli.py

Назначение: Загрузка модели на HuggingFace через API

Использование:

# Отредактируйте параметры:
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