logo
0
0
Login
docs: 更新 README,加中文版 _zh_cn 优先展示

Hunyuan3D-2 on CNB

本仓库演示了使用 CNB “云原生开发”,一键快速体验 hunyuan3d-2 模型的方法。有三种快速开始方式,根据自己习惯,选择其中一种即可。

  1. 代码方式
  2. Notebook 方式
  3. Gradio app 方式

快速开始

1.代码方式

在命令行直接执行 python start-hunyuan-3d-demo.py 即可. 代码会加载模型,使用样例图片,生成两个 3d 结果文件 demo.glb 和 demo-paint.glb

执行耗时约10分钟。

2.Notebook方式

  • 命令行执行 jupyter lab list 查看环境启动的 jupyter 地址
  • 选择 start-notebook-demo.ipynb 文件, "Run All" 运行所有-> Existing Jupyter Server,弹出框中粘贴 jupyter 地址
  • 代码块会自动按顺序执行,观察输出即可

3.使用 Gradia app 方式

  • 在命令行运行 sh start-gradio-app.sh 会启动app,然后在浏览器中访问即可。
  • 访问地址为自己当前云原生开发页面浏览器地址,拼接 -8080 后缀,例如:
https://cnb-cfo-1imrso1tp-001.cnb.space/?folder=/workspace 拼接成 https://cnb-cfo-1imrso1tp-001-8080.cnb.space/?folder=/workspace
  • 使用限制:当前网页请求站点最长超时60s,如果纹理图生成较慢,页面会报超时失败。

注意事项

  • 远程开发环境,启动后等一分钟,后台会编译安装 hunyuan 的依赖,在构建日志里能看到。

待确认疑问点

  • 使用代码直接调用模型时,生成一个Paint 3d 文件耗时要6分钟,且未看到GPU有负载(一直0%,就100%了几秒),不确定是否正常,需要hunyuan的研发核实下。 Hunyuan3d-dit-v2的模型观察正常。
  • 换了其他图片,有报错,看着和hunyuan代码兼容性及图片通道数有关。
  • 制作开发镜像时,安装依赖库 custom_rasterizer 时显卡兼容性会报错,设置环境变量后,不确定是否正确。需要hunyuan研发核实下。