本页由英文机器翻译而成。阅读英文原文。

本地 Python 模型运行时

官方3Dv1.0.2aigd.python
安装 还没安装应用?免费下载
或从终端安装
gamedev pkg add aigd.python

概览

在这台电脑上用 PyTorch 运行没有 C++ 或 ONNX 移植版本的本地模型(3D 生成与骨骼绑定),每个模型都有独立的私有 Python 环境,绝不会影响你自己的 Python。TripoSG、Hunyuan3D-2.1 Shape 和 SkinTokens 等模型是单独的软件包。

AI Game Dev 的本地 Python 运行时:它用 PyTorch 在这台电脑上运行本地模型,适用于没有 C++ 或 ONNX 移植版本的模型,例如图生 3D、网格细化和自动绑定骨骼。一切都在你的电脑上运行,不消耗你的 AI Game Dev 额度。它适合想把概念图变成 3D 形状、或在自己的 GPU 上为角色绑定骨骼的游戏开发者。模型本身是单独的软件包。

你可以做什么

  • 用本地图生 3D 模型把一张概念图变成 3D 形状,例如 TripoSG 1.5B、Hunyuan3D-2.1 Shape 或 Step1X-3D Geometry。
  • 在 Asset Studio 中用 SkinTokens 为角色或生物网格绑定骨骼(骨架和蒙皮权重)。
  • 你自己的 Python 安装完全不受影响:每个模型都有自己独立的私有环境。

示例请求

  • “用 TripoSG 在我的 GPU 上把 Assets/Concepts/goblin.png 变成 3D 形状。”
  • “用 Hunyuan3D-2.1 Shape 在本地把这张宝箱图片做成 3D 模型。”
  • “用 Step1X-3D Geometry 把 Assets/Concepts/crate.png 变成 3D 形状。”

工作原理

这个包只包含数据(aigd-package.json,没有代码)。它告诉 AI Game Dev 为你的电脑下载哪个版本的 uv。应用使用 uv 为每个模型构建独立的 Python 环境。你自己的 Python 绝不会被改动。 不会全局安装任何东西,不会往 PATH 里写入任何东西,也不会写入 Windows 注册表。一切都放在应用的模型库中,即 python/。

模型是单独的软件包

这个包不包含任何模型。请从包浏览器安装模型包,然后在模型面板中下载其文件。未经你确认不会下载任何内容,而且你会先看到文件大小。

模型首次加载时,应用会构建它的 Python 环境。它会下载 Python 3.12 和 PyTorch 以及该模型的其他库,CUDA 版本大约为 2 到 4 GB。这可能需要几分钟。之后的加载会复用该环境。如果下载中断,下次加载会重新开始,并复用所有已下载的文件。

会下载哪些内容

  • uv —— 上游发布版本 0.13.7,通过 sha256 固定。应用会为你的电脑选择其中一个变体:
变体电脑下载
win-x64-cudaWindows,NVIDIA GPU(驱动 572.61 或更新,计算能力 7.0 或更高)15 MB
win-x64-cpu没有受支持 NVIDIA GPU 的 Windows15 MB
linux-x64-cudaLinux x64,NVIDIA GPU(驱动 570.124 或更新,计算能力 7.0 或更高),glibc 2.28 或更新17 MB
linux-x64-cpu没有受支持 NVIDIA GPU 的 Linux x64,glibc 2.28 或更新17 MB
darwin-arm64-metalApple 芯片的 Mac,macOS 14 或更新(PyTorch 通过 MPS 使用 GPU)14 MB

Linux 属于预览版。 尚未在真实的 Linux GPU 上测试过。

  • Python 3.12.16(如果某个模型的库有需要,则为 3.11.18 或 3.13.18):来自 python-build-standalone 的 CPython 构建。uv 会下载它,并用固定版本 uv 中内置的校验和进行校验。
  • 每个模型的 Python 库:PyTorch 2.11(NVIDIA 上为 CUDA 12.8)以及模型自身的库,来自 PyPI 和 download.pytorch.org。应用为每个模型提供精确的列表,按版本和 sha256 固定。安装只使用 wheel,因此不会在你的电脑上编译任何内容。文件与 sha256 不匹配会中止安装。

模型离线运行。它们的权重只来自你在模型面板中下载的文件。

要求

  • 每个模型包都会说明各自的 GPU 和显存需求。
  • 应用从不安装驱动或系统库。如果 PyTorch 无法识别你的 GPU,模型就不会加载,应用会提示你更新 NVIDIA 驱动。
  • AI Game Dev 0.32.0-beta.6 或更新版本。

许可证

  • 本包 —— MIT。
  • uv —— MIT OR Apache-2.0,© Astral Software Inc.(MIT、Apache-2.0)。
  • CPython —— PSF License 2.0,© Python Software Foundation。python-build-standalone 发行版还包含其所捆绑库的许可证(OpenSSL、SQLite、zlib 等)。其构建脚本为 MPL-2.0(许可证)。
  • PyTorch —— BSD-3-Clause,© Meta Platforms 及贡献者(许可证)。
  • NVIDIA CUDA 库(cuBLAS、cuDNN 等),仅出现在 CUDA 变体中。它们包含在 CUDA 版 PyTorch wheel 里,依据 NVIDIA CUDA EULA 重新分发。
  • 每个模型包都会声明各自的许可证。部分 3D 模型对使用地域或商业用途有限制。模型面板会在下载任何内容之前显示这些限制。

必需的署名:本包没有。模型包会注明各自的署名要求。

限制:本包没有。NVIDIA CUDA EULA 允许这些库与本应用一起使用,但不得单独再分发。

所有文件都从其上游发布方下载(GitHub、Python 包索引、download.pytorch.org)。AI Game Dev 不托管这些文件。

版本

本地 Python 模型运行时 的发布版本
版本发布时间需要应用
1.0.2最新0.32.0-beta.6 或更高版本
1.0.10.32.0-beta.6 或更高版本

安装

在桌面应用中安装

打开包窗口(状态栏中的包图标),选择浏览,搜索 aigd.python,然后点击添加到项目。

还没安装应用?免费下载 AI Game Dev,支持 Windows、macOS 和 Linux。

从终端安装

在项目文件夹中使用 gamedev CLI:

gamedev pkg add aigd.python

环境要求

  • AI Game Dev 0.32.0-beta.6 或更高版本

进一步了解包

安装
gamedev pkg add aigd.python