| # 📚 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 | |