本地 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-cuda | Windows,NVIDIA GPU(驱动 572.61 或更新,计算能力 7.0 或更高) | 15 MB |
win-x64-cpu | 没有受支持 NVIDIA GPU 的 Windows | 15 MB |
linux-x64-cuda | Linux 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-metal | Apple 芯片的 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 不托管这些文件。
版本
| 版本 | 发布时间 | 需要应用 |
|---|---|---|
| 1.0.2最新 | 0.32.0-beta.6 或更高版本 | |
| 1.0.1 | 0.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