# 本地 Python 模型运行时

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

- ID: `aigd.python`
- 来源: 官方 (第一方 `aigd.*`)
- 分类: 3D
- 发布者: AI Game Dev (`aigd`), 已验证
- 最新版本: 1.0.2 (发布于 2026-11-22)
- 许可证: MIT
- 需要 AI Game Dev 应用: `>=0.32.0-beta.6`
- 原生代码: 否
- 评分: 暂无评分
- HTML 页面: https://ai-game.dev/zh-hans/packages/aigd.python

## 安装

使用 gamedev CLI，在项目文件夹中运行：

```bash
gamedev pkg add aigd.python
```

在桌面应用中：打开 Packages 窗口（状态栏中的包图标），选择 **Browse**，搜索 `aigd.python`，然后点击 **Add to Project**。更多：https://ai-game.dev/docs/wiki/app/packages

## 版本

| 版本 | 发布时间 | 需要应用 | 备注 |
|---|---|---|---|
| 1.0.2 | 2026-11-22 | `>=0.32.0-beta.6` | 最新 |
| 1.0.1 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## 描述

````markdown
# 本地 Python 模型运行时（`aigd.python`）

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

## 你可以做什么

- 用本地图生 3D 模型把一张概念图变成 3D 形状，例如 [TripoSG 1.5B](https://ai-game.dev/packages/aigd.model3d-triposg)、[Hunyuan3D-2.1 Shape](https://ai-game.dev/packages/aigd.model3d-hunyuan3d-2-1-shape) 或 [Step1X-3D Geometry](https://ai-game.dev/packages/aigd.model3d-step1x-3d-geometry)。
- 在 Asset Studio 中用 [SkinTokens](https://ai-game.dev/packages/aigd.model3d-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](https://github.com/astral-sh/uv)。应用使用 uv 为每个模型构建独立的 Python 环境。**你自己的 Python 绝不会被改动。** 不会全局安装任何东西，不会往 `PATH` 里写入任何东西，也不会写入 Windows 注册表。一切都放在应用的模型库中，即 `python/`。

## 模型是单独的软件包

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

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

## 会下载哪些内容

- **uv** —— 上游发布版本 [`0.13.7`](https://github.com/astral-sh/uv/releases/tag/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](https://github.com/astral-sh/python-build-standalone) 的 CPython 构建。uv 会下载它，并用固定版本 uv 中内置的校验和进行校验。
- **每个模型的 Python 库**：PyTorch 2.11（NVIDIA 上为 CUDA 12.8）以及模型自身的库，来自 [PyPI](https://pypi.org) 和 [download.pytorch.org](https://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](https://github.com/astral-sh/uv/blob/0.13.7/LICENSE-MIT)、[Apache-2.0](https://github.com/astral-sh/uv/blob/0.13.7/LICENSE-APACHE)）。
- CPython —— [PSF License 2.0](https://docs.python.org/3/license.html)，© Python Software Foundation。python-build-standalone 发行版还包含其所捆绑库的许可证（OpenSSL、SQLite、zlib 等）。其构建脚本为 MPL-2.0（[许可证](https://github.com/astral-sh/python-build-standalone/blob/main/LICENSE)）。
- PyTorch —— BSD-3-Clause，© Meta Platforms 及贡献者（[许可证](https://github.com/pytorch/pytorch/blob/main/LICENSE)）。
- NVIDIA CUDA 库（cuBLAS、cuDNN 等），仅出现在 CUDA 变体中。它们包含在 CUDA 版 PyTorch wheel 里，依据 [NVIDIA CUDA EULA](https://docs.nvidia.com/cuda/eula/) 重新分发。
- 每个模型包都会声明各自的许可证。部分 3D 模型对使用地域或商业用途有限制。模型面板会在下载任何内容之前显示这些限制。

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

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

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