Gerchegg commited on
Commit
195404a
·
verified ·
1 Parent(s): e2d1a1c

Upload UPDATE_NOTES.md with huggingface_hub

Browse files
Files changed (1) hide show
  1. UPDATE_NOTES.md +97 -0
UPDATE_NOTES.md ADDED
@@ -0,0 +1,97 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # 🔄 Обновление Qwen-ImageForFlo-Advanced
2
+
3
+ ## ✨ Что изменено
4
+
5
+ ### 1. Опциональный импорт `spaces`
6
+ - ✅ Модуль `spaces` теперь опциональный
7
+ - ✅ Работает на RunPod, локально и в HF Spaces
8
+ - ✅ Автоматически определяет окружение
9
+
10
+ ### 2. Автоматическая загрузка ControlNet
11
+ - ✅ **Автоматически проверяет** наличие ControlNet в кэше
12
+ - ✅ **Автоматически скачивает** если модели нет
13
+ - ✅ **Определяет путь** кэша (RunPod: `/workspace/.cache` или локально: `~/.cache`)
14
+ - ✅ Корректная обработка ошибок
15
+
16
+ ---
17
+
18
+ ## 📝 Что делает новый код
19
+
20
+ ### Проверка окружения:
21
+ ```python
22
+ # Используем /workspace/.cache на RunPod или ~/.cache локально
23
+ if os.path.exists("/workspace"):
24
+ cache_base = Path("/workspace/.cache")
25
+ else:
26
+ cache_base = Path.home() / ".cache"
27
+ ```
28
+
29
+ ### Автоматическая загрузка:
30
+ ```python
31
+ if not cache_dir.exists():
32
+ logger.info(" 📥 ControlNet не найден в кэше, скачиваю...")
33
+ snapshot_download(
34
+ repo_id=controlnet_model_id,
35
+ local_dir=cache_dir,
36
+ token=hf_token
37
+ )
38
+ logger.info(" ✓ ControlNet успешно загружен в кэш")
39
+ ```
40
+
41
+ ---
42
+
43
+ ## 🚀 Как использовать
44
+
45
+ ### На RunPod:
46
+
47
+ ```bash
48
+ # 1. Скачать проект
49
+ cd /workspace
50
+ hf download Gerchegg/Qwen-ImageForFlo-Advanced --repo-type space --local-dir Qwen-ImageForFlo-Advanced
51
+
52
+ # 2. Установить зависимости
53
+ cd Qwen-ImageForFlo-Advanced
54
+ pip install -r requirements.txt
55
+
56
+ # 3. Запустить (ControlNet скачается автоматически!)
57
+ python app.py
58
+ ```
59
+
60
+ ### Локально:
61
+
62
+ ```bash
63
+ # Клонировать и запустить
64
+ git clone https://huggingface.co/spaces/Gerchegg/Qwen-ImageForFlo-Advanced
65
+ cd Qwen-ImageForFlo-Advanced
66
+ pip install -r requirements.txt
67
+ python app.py
68
+ ```
69
+
70
+ ---
71
+
72
+ ## ✅ Преимущества
73
+
74
+ 1. **Не нужно вручную качать ControlNet** - всё автоматически
75
+ 2. **Работает везде** - RunPod, локально, HF Spaces
76
+ 3. **Умный кэш** - использует правильную директорию в зависимости от окружения
77
+ 4. **Graceful degradation** - если ControlNet не загружается, приложение продолжит работать
78
+
79
+ ---
80
+
81
+ ## 📊 Загружаемые модели
82
+
83
+ 1. **Text2Image** - Qwen-Soloband-Diffusers (~40GB)
84
+ 2. **Image2Image** - Создается из Text2Image
85
+ 3. **ControlNet** - InstantX/Qwen-Image-ControlNet-Union (~3GB) - **АВТОМАТИЧЕСКИ!**
86
+
87
+ ---
88
+
89
+ ## 🎯 Итог
90
+
91
+ Теперь для запуска Advanced версии достаточно:
92
+ 1. Скачать проект
93
+ 2. Установить зависимости
94
+ 3. Запустить app.py
95
+
96
+ **Всё остальное скачается автоматически!** 🚀
97
+