Upload folder using huggingface_hub

DEPLOYMENT_BUCKET.md

@@ -34,21 +34,20 @@ pipeline 的第 1 个位置，人物图放到第 2 个位置。
 
 ```text
 Davidscut/Tryon-demo-storage
-├── JoyAI-Image/
-│   └── xvideo/
-├── configs/
-│   └── editing_exp/
-│       └── edit_1024p_demo.py
+├── JoyAI-Image-a4afa71/
+│   ├── xvideo/
+│   └── configs/
+│       └── editing_exp/
+│           └── edit_1024p_demo.py
+├── processor/
+├── text_encoder/
+├── tokenizer/
 ├── transformer/
 │   ├── diffusion_pytorch_model.safetensors.index.json
 │   ├── diffusion_pytorch_model-00001-of-00007.safetensors
 │   └── ...
-└── FireRed-Image-Edit-1.0/
-    ├── text_encoder/
-    ├── processor/
-    ├── tokenizer/
-    └── vae/
-        └── diffusion_pytorch_model.safetensors
+└── vae/
+    └── diffusion_pytorch_model.safetensors
 ```
 
 如果你的 DiT 是原始 `.pth` 文件，也可以这样放：
@@ -77,7 +76,7 @@ JOY_VAE_PATH=FireRed-Image-Edit-1.0/vae/Wan2.1_VAE.pth
 如果 Bucket 中是 safetensors 文件，则设置：
 
 ```text
-JOY_VAE_PATH=FireRed-Image-Edit-1.0/vae/diffusion_pytorch_model.safetensors
+JOY_VAE_PATH=vae/diffusion_pytorch_model.safetensors
 ```
 
 ## 3. Space 仓库内容
@@ -108,16 +107,20 @@ Bucket 挂载到 `/models` 后，最小变量如下：
 
 ```text
 MODEL_LOCAL_DIR=/models
-JOY_CONFIG_PATH=configs/editing_exp/edit_1024p_demo.py
+JOY_CODE_DIR=/models/JoyAI-Image-a4afa71
+JOY_CONFIG_PATH=JoyAI-Image-a4afa71/configs/editing_exp/edit_1024p_demo.py
 JOY_TRANSFORMER_PATH=transformer
 JOY_DIT_CKPT_TYPE=safetensor
-JOY_MODEL_PATH=FireRed-Image-Edit-1.0
-JOY_VAE_PATH=FireRed-Image-Edit-1.0/vae/diffusion_pytorch_model.safetensors
+JOY_MODEL_PATH=.
+JOY_VAE_PATH=vae/diffusion_pytorch_model.safetensors
+JOY_TEXT_ENCODER_PATH=text_encoder
+JOY_PROCESSOR_PATH=processor
+JOY_TOKENIZER_PATH=tokenizer
 HF_HOME=/data/.huggingface
 ```
 
-如果 `xvideo` 不在 `/models/JoyAI-Image/xvideo`、`/models/code/xvideo` 或
-`/models/xvideo`，需要显式设置：
+如果 `xvideo` 不在 `/models/JoyAI-Image-a4afa71/xvideo`、`/models/JoyAI-Image/xvideo`、
+`/models/code/xvideo` 或 `/models/xvideo`，需要显式设置：
 
 ```text
 JOY_CODE_DIR=/models/你的源码目录
@@ -126,9 +129,9 @@ JOY_CODE_DIR=/models/你的源码目录
 如果 text encoder、processor、tokenizer 是分开的目录，建议也显式设置：
 
 ```text
-JOY_TEXT_ENCODER_PATH=FireRed-Image-Edit-1.0/text_encoder
-JOY_PROCESSOR_PATH=FireRed-Image-Edit-1.0/processor
-JOY_TOKENIZER_PATH=FireRed-Image-Edit-1.0/tokenizer
+JOY_TEXT_ENCODER_PATH=text_encoder
+JOY_PROCESSOR_PATH=processor
+JOY_TOKENIZER_PATH=tokenizer
 ```
 
 路径可以写相对 `/models` 的路径，也可以写绝对路径。
@@ -167,6 +170,8 @@ python3 -m pip install -U "huggingface_hub>=1.9.0,<2.0"
 如果看到 `AttributeError: 'HfApi' object has no attribute 'set_space_volumes'`，
 说明本地部署环境里的 `huggingface_hub` 太旧，需要先执行上面的升级命令。
 这是本地部署脚本依赖，不是 Space 运行时模型依赖。
+Space 运行时的 `requirements.txt` 需要保持 `huggingface_hub>=0.34.0,<1.0`，
+因为 `transformers>=4.57.1` 依赖 `huggingface-hub<1.0`。
 
 设置 token：
 
@@ -198,7 +203,7 @@ python deploy_bucket_space.py \
   --private
 ```
 
-如果源码目录不是推荐结构，例如放在 Bucket 的 `JoyAI-Image-a4afa71`：
+如果需要显式覆盖当前推荐结构，可以这样写完整参数：
 
 ```bash
 python deploy_bucket_space.py \
@@ -207,9 +212,13 @@ python deploy_bucket_space.py \
   --mount-path /models \
   --joy-code-dir /models/JoyAI-Image-a4afa71 \
   --config-path JoyAI-Image-a4afa71/configs/editing_exp/edit_1024p_demo.py \
-  --transformer-path checkpoints/global_step38000/step_38000.pth \
-  --dit-ckpt-type pt \
-  --vae-path FireRed-Image-Edit-1.0/vae/Wan2.1_VAE.pth \
+  --transformer-path transformer \
+  --dit-ckpt-type safetensor \
+  --model-path . \
+  --vae-path vae/diffusion_pytorch_model.safetensors \
+  --text-encoder-path text_encoder \
+  --processor-path processor \
+  --tokenizer-path tokenizer \
   --private
 ```
 
@@ -299,9 +308,9 @@ FireRed-Image-Edit-1.0/
 显式设置：
 
 ```text
-JOY_TEXT_ENCODER_PATH=FireRed-Image-Edit-1.0/text_encoder
-JOY_PROCESSOR_PATH=FireRed-Image-Edit-1.0/processor
-JOY_TOKENIZER_PATH=FireRed-Image-Edit-1.0/tokenizer
+JOY_TEXT_ENCODER_PATH=text_encoder
+JOY_PROCESSOR_PATH=processor
+JOY_TOKENIZER_PATH=tokenizer
 ```
 
 `CUDA is not available`