https://github.com/Tencent-Hunyuan/HY-Motion-1.0

install：
git clone https://github.com/Tencent-Hunyuan/HY-Motion-1.0.git
cd HY-Motion-1.0/
# Make sure git-lfs is installed
git lfs pull
pip install -r requirements.txt

这里大概率会提示没有pip ，

1、下载python便携版，下载:https://www.python.org/downloads/windows/

解压到智能体的Python311-embed目录中，找到python311._pth,去掉#号 import site

2、安装pip，下载pip安装文件 git-pip.py 到Python311-embed，dos命令窗口输入：

python.exe get-pip.py

3、安装pytorch，Python311-embed目录地址窗口敲入cmd，重新打开dos命令窗口输入：

dos命令>python -m pip install torch torchvision --index-url https://download.pytorch.org/whl/cu128

下载完成

4、按照requirements安装依赖，但是它在python的上一级目录。所以要用到 ..\

python -m pip install -r python -m pip install -r ..\requirements.txt

下载hy-motion很多依赖包

5、下载gradio

HY-Motion-1.0\Python311-embed> python -m pip install gradio

遇到版本冲突，tokenizers 0.21.4 requires huggingface-hub<1.0,>=0.16.4；transformers 4.53.3 requires huggingface-hub<1.0,>=0.30.0 ，gradio 6.3.0 明确要求 huggingface-hub 版本满足 ≥0.33.5 且 <2.0 得出要下载一个huggingface-hub<1.0,>=0.33.5的

查看包版本：

HY-Motion-1.0\Python311-embed> python -m pip list

果然1.3.2！

降低版本！

HY-Motion-1.0\Python311-embed> python.exe -m pip install huggingface-hub==0.50.0 -i https://pypi.tuna.tsinghua.edu.cn/simple

解决办法1>换源：

python -m pip install huggingface-hub==0.33.5 -i https://pypi.org/simple/

python -m pip install huggingface-hub==0.30.1  -i https://mirrors.aliyun.com/pypi/simple/

解决办法2>查版本：到处没有咋办？先pypi官方时光机查查有没有这个版本,拿到确认有的版本号再来！

HY-Motion-1.0\Python311-embed> python.exe -m pip install huggingface-hub==0.36.0 -i https://pypi.tuna.tsinghua.edu.cn/simple

验证安装：若能正常输出版本号且无报错，说明安装成功，依赖冲突已解决：

HY-Motion-1.0\Python311-embed>python.exe -c "import huggingface_hub; print('huggingface-hub 版本：', huggingface_hub.__version__)"

目录结构有了！下载大模型！git的智能体目录https://github.com/Tencent-Hunyuan/HY-Motion-1.0找到

5、下载大模型

这里点到huggingface.co 下载大模型，https://huggingface.co/tencent/HY-Motion-1.0/tree/main/HY-Motion-1.0

可能比较慢，huggingface.co 换成hf-mirror.com 选择国内镜像。右键复制链接，
https://hf-mirror.com/tencent/HY-Motion-1.0/tree/main/HY-Motion-1.0

按照目录结构存放大模型.

ckpts/
├── tencent/
│   ├── HY-Motion-1.0/         # 放置hf-mirror.com下的 config.yml and latest.ckpt
│   └── HY-Motion-1.0-Lite/    # 放置lite轻量化版的，如果你需要
├── clip-vit-large-patch14/     # CLIP weights
├── Qwen3-8B/                   # Qwen text encoder weights
└── Text2MotionPrompter/        # vLLM Rewriter weights (Optional)

https://hf-mirror.com/Qwen/Qwen3-8B/tree/main
https://hf-mirror.com/openai/clip-vit-large-patch14/tree/main
https://hf-mirror.com/Text2MotionPrompter/Text2MotionPrompter/tree/main
下载所有的文件放入对应的文件夹
或者建立一个downloadCKPTS.bat下载文件

@echo off
rem 改用rem注释（避免::导致的参数格式错误）
rem 设置中文GBK编码，解决乱码问题
chcp 936 >nul

rem 切换到项目根目录（路径带空格必须加引号）
cd /d "D:\Program Files\AI\HY-motion\HY-Motion-1.0"

echo ========================
echo 【第一步】安装/升级依赖（确保tqdm/huggingface-hub可用）
echo ========================
"Python311-embed\python.exe" -m pip install --upgrade huggingface-hub tqdm -i https://pypi.tuna.tsinghua.edu.cn/simple
echo 依赖安装完成，按任意键开始下载模型...
pause >nul

echo.
echo ========================
echo 【第二步】下载Qwen3-8B
echo ========================
rem 复用你确认能执行的命令结构，仅保留核心参数
"Python311-embed\python.exe" -c "import os; os.environ['HF_ENDPOINT']='https://hf-mirror.com'; from huggingface_hub import snapshot_download; from tqdm import tqdm; tqdm.refresh_interval = 1; snapshot_download(repo_id='Qwen/Qwen3-8B', local_dir='./ckpts/Qwen3-8B', local_dir_use_symlinks=False, resume_download=True)"
echo Qwen3-8B下载完成/暂停，按任意键继续下载CLIP...
pause >nul

echo.
echo ========================
echo 【第三步】下载clip-vit-large-patch14
echo ========================
rem 仅替换repo_id和local_dir，其余和你验证的命令完全一致
"Python311-embed\python.exe" -c "import os; os.environ['HF_ENDPOINT']='https://hf-mirror.com'; from huggingface_hub import snapshot_download; from tqdm import tqdm; tqdm.refresh_interval = 1; snapshot_download(repo_id='openai/clip-vit-large-patch14', local_dir='./ckpts/clip-vit-large-patch14', local_dir_use_symlinks=False, resume_download=True)"
echo CLIP下载完成/暂停，按任意键继续下载Text2MotionPrompter...
pause >nul

echo.
echo ========================
echo 【第四步】下载Text2MotionPrompter
echo ========================
rem 同样复用验证过的命令结构
"Python311-embed\python.exe" -c "import os; os.environ['HF_ENDPOINT']='https://hf-mirror.com'; from huggingface_hub import snapshot_download; from tqdm import tqdm; tqdm.refresh_interval = 1; snapshot_download(repo_id='Text2MotionPrompter/Text2MotionPrompter', local_dir='./ckpts/Text2MotionPrompter', local_dir_use_symlinks=False, resume_download=True)"
echo 所有模型下载完成！按任意键关闭窗口...
pause >nul

在系统环境变量中设置 USE_HF_MODELS = 0

在python.exe目录创建 开始.txt 写入以下内容，为了能兼容中文，保存为ascii编码。

echo 正在启动 HY-Motion-1.0 Gradio 服务
echo 开始运行
python ..\gradio_app.py
timeout /t 5 /nobreak > nul
start http://localhost:7860
pause

再改为开始.bat文件。把它创建快捷方式放到上一级目录。
双击运行，又提示缺少依赖。

在gradio_app.py前面加入搜索当前目录的代码

import sys
import os
# 获取当前文件所在目录（即项目根目录）
current_dir = os.path.dirname(os.path.abspath(__file__))
# 将当前目录添加到 Python 搜索路径
sys.path.append(current_dir)

模块加入引导文件__init__.py，空的都行！

再次点击根目录的>开始.bat的快捷方式