教程 | 安装部署3DTopia-XL模型，直出工业级PBR资产

wisemodel开源社区

2024-10-16 23:24始智AI wisemodel官方账号

新一代的三维生成大模型3DTopia-XL，能够从图片或文字单阶段直出具有PBR（物理渲染）材质的高质量三维数字资产。3DTopia-XL已将代码、预训练模型和技术报告开源，模型和代码都已经发布在始智AI wisemodel开源社区，wisemodel社区上也已经提供了3DTopia-XL的镜像，可以通过创建开发环境来使用3DTopia-XL模型了。

使用3DTopia-XL镜像直接运行

点击模型详情页-“训练或微调”按钮，创建一个开发环境，选择“3DTopia-XL-Deploy”的镜像，使用1张A5000或3090的配置，选择3DTopia-XL的模型文件路径“/llm/ZhaoxiChen/3DTopia-XL”，完成其他属性的填写或选择，然后直接点击下一步：

然后确认一下计费方式，如果是简单体验可以选择按量计费的模型，如果需要使用更长的时间，也可以选择包周或包月的模式，相比于按量有一些折扣。确定计费方式之后，可以直接点击提交订单：

创建完成之后，等待1分钟左右，开发环境进入运行中的状态，可以通过ssh登录到容器内或者通过notebook的方式把3DTopia-XL服务启动起来。

下面通过notebook的终端来把3DTopia-XL服务启动起来：

在notebook终端里操作跟ssh登录的容器的操作基本是一样：

先到代码所在的路径：

cd /home

cd 3DTopia-XL

进入代码路径之后直接执行：

python app.py

发现会报错，重新设置一下PYTHONPATH

然后再次执行：python app.py

这次3DTopia-XL服务正常启动

服务启动之后回到开发环境详情里，点击“服务端口”选项卡，申请一个公网访问的地址，申请好之后直接复制链接到浏览器打开

发现服务确实正常启动了，并且可以直接在线运行通过图片生成3D内容了。

通过ssh登录容器的操作也基本一样。

使用基础镜像重新开始安装部署

如果希望了解3DTopia-XL部署的全过程，也可以选择使用基础镜像，然后按照下面的流程来实现模型的安装和部署。先创建一个开发环境，主要选择和填写如下内容：

然后确认一下计费方式，这里选择按量的方式，确认之后提交订单：

下面通过ssh登录的方式进行3DTopia-XL的安装和部署：

然后先把代码里的依赖安装一下：pip install -r requirements.txt

安装过程中因为github连接的问题，中间好几次失败，只能多重试几次。

重试几次之后总算是成功，开始安装相关的依赖，安装过程中又碰到一个报错，提示pymeshlab==0.2版本不对，查了一下这个安装包的版本，修改一下requirements.txt里相应的安装包版本：pymeshlab==2022.2，然后重新执行：pip install -r requirements.txt

再次安装之后，所有依赖都成功安装了。

下面继续执行 bash install.sh，这时报make: python: No such file or directory的错误，将python的路径加到PATH里去，执行export PATH=/opt/conda/bin/:$PATH ，然后重新执行 bash install.sh 之后可以正常执行。

然后尝试执行一下 python app.py

开始会报找不到“imageio”的错误，应该是pythonpath的问题，执行一下export PYTHONPATH=/usr/local/lib/python3.10/dist-packages 之后问题解决了，但又报了 NumPy 版本兼容的问题，下面重新安装numpy，pip install numpy==1.26.0