# Entorno de ejecución local de modelos Python

> Ejecuta en este equipo modelos locales que no tienen port a C++ ni a ONNX (generación 3D y rigging) con PyTorch, en un entorno Python privado por modelo que nunca toca tu propio Python. Modelos como TripoSG, Hunyuan3D-2.1 Shape y SkinTokens son paquetes aparte.

- Id: `aigd.python`
- Origen: Oficial (propio `aigd.*`)
- Categoría: 3D
- Editor: AI Game Dev (`aigd`), verificado
- Última versión: 1.0.2 (publicado el 2026-11-22)
- Licencia: MIT
- Requiere la app AI Game Dev: `>=0.32.0-beta.6`
- Código nativo: no
- Valoración: aún sin valoraciones
- Página HTML: https://ai-game.dev/es/packages/aigd.python

## Instalar

Con la CLI gamedev, en la carpeta del proyecto:

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

En la app de escritorio: abre la ventana Packages (el icono de paquete en la barra de estado), selecciona **Browse**, busca `aigd.python` y haz clic en **Add to Project**. Más: https://ai-game.dev/docs/wiki/app/packages

## Versiones

| Versión | Publicado | Requiere app | Notas |
|---|---|---|---|
| 1.0.2 | 2026-11-22 | `>=0.32.0-beta.6` | la más reciente |
| 1.0.1 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## Descripción

````markdown
# Entorno de ejecución local de modelos Python (`aigd.python`)

El entorno de ejecución local de Python de AI Game Dev: ejecuta modelos locales en este equipo con [PyTorch](https://pytorch.org), para modelos que no tienen port a C++ ni a ONNX, como image-to-3D, refinamiento de mallas y auto-rigging. Todo se ejecuta en tu equipo y no consume nada de tu cuota de AI Game Dev. Está pensado para desarrolladores de juegos que quieren convertir concept art en formas 3D o crear el rig de personajes en su propia GPU. Los modelos en sí son paquetes aparte.

## Qué puedes hacer

- Convertir una sola imagen de concepto en una forma 3D con un modelo local de image-to-3D, por ejemplo [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) o [Step1X-3D Geometry](https://ai-game.dev/packages/aigd.model3d-step1x-3d-geometry).
- Crear el rig de la malla de un personaje o criatura (esqueleto y pesos de skinning) con [SkinTokens](https://ai-game.dev/packages/aigd.model3d-skintokens) en Asset Studio.
- Mantener tu propia instalación de Python intacta: cada modelo tiene su propio entorno privado.

## Ejemplos de solicitudes

- "Convierte `Assets/Concepts/goblin.png` en una forma 3D con TripoSG en mi GPU."
- "Crea localmente un modelo 3D de esta imagen de cofre del tesoro con Hunyuan3D-2.1 Shape."
- "Convierte `Assets/Concepts/crate.png` en una forma 3D con Step1X-3D Geometry."

## Cómo funciona

Este paquete es solo datos (`aigd-package.json`, sin código). Le indica a AI Game Dev qué versión de [uv](https://github.com/astral-sh/uv) descargar para tu equipo. La app usa uv para crear un entorno de Python privado para cada modelo. **Tu propio Python nunca se toca.** No se instala nada de forma global, nada va a `PATH` y no se escribe nada en el registro de Windows. Todo vive en el almacén de modelos de la app, en `python/`.

## Los modelos son paquetes aparte

Este paquete no contiene ningún modelo. Instala un paquete de modelo desde el explorador de Paquetes y luego descarga sus archivos desde el panel Modelos. Nada se descarga sin tu confirmación y ves el tamaño antes.

La primera vez que se carga un modelo, la app crea su entorno de Python. Descarga Python 3.12 y PyTorch junto con las demás bibliotecas de ese modelo, lo que supone de 2 a 4 GB para una compilación CUDA. Esto puede tardar varios minutos. Las cargas posteriores reutilizan el entorno. Si se interrumpe una descarga, la siguiente carga vuelve a empezar y reutiliza todos los archivos ya descargados.

## Qué se descarga

- **uv**: versión upstream [`0.13.7`](https://github.com/astral-sh/uv/releases/tag/0.13.7), fijada por sha256. La app elige una variante para tu equipo:

  | Variante | Equipo | Descarga |
  |---|---|---|
  | `win-x64-cuda` | Windows, GPU NVIDIA (controlador 572.61 o posterior, compute capability 7.0 o posterior) | 15 MB |
  | `win-x64-cpu` | Windows sin una GPU NVIDIA compatible | 15 MB |
  | `linux-x64-cuda` | Linux x64, GPU NVIDIA (controlador 570.124 o posterior, compute capability 7.0 o posterior), glibc 2.28 o posterior | 17 MB |
  | `linux-x64-cpu` | Linux x64 sin una GPU NVIDIA compatible, glibc 2.28 o posterior | 17 MB |
  | `darwin-arm64-metal` | Mac con Apple silicon, macOS 14 o posterior (PyTorch usa la GPU a través de MPS) | 14 MB |

  **Linux es una vista previa.** Todavía no se ha probado en una GPU Linux real.
- **Python** 3.12.16 (3.11.18 o 3.13.18 para un modelo cuyas bibliotecas lo requieran): una compilación de CPython de [python-build-standalone](https://github.com/astral-sh/python-build-standalone). uv la descarga y la comprueba con las sumas de verificación incluidas en la versión de uv fijada.
- **Las bibliotecas de Python de cada modelo**: PyTorch 2.11 (CUDA 12.8 en NVIDIA) y las bibliotecas propias del modelo, desde [PyPI](https://pypi.org) y [download.pytorch.org](https://download.pytorch.org). La app incluye la lista exacta para cada modelo, fijada por versión y sha256. Las instalaciones usan solo wheels, así que no se compila nada en tu equipo. Un archivo que no coincida con su sha256 detiene la instalación.

Los modelos funcionan sin conexión. Sus pesos provienen únicamente de los archivos que descargaste en el panel Modelos.

## Requisitos

- Cada paquete de modelo indica sus propias necesidades de GPU y memoria de vídeo.
- La app nunca instala controladores ni bibliotecas del sistema. Si PyTorch no detecta tu GPU, el modelo no se carga y la app te indica que actualices el controlador de NVIDIA.
- AI Game Dev 0.32.0-beta.6 o posterior.

## Licencia

- Este paquete: 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. La distribución python-build-standalone también incluye las licencias de las bibliotecas que empaqueta (OpenSSL, SQLite, zlib y otras). Sus scripts de compilación son MPL-2.0 ([licencia](https://github.com/astral-sh/python-build-standalone/blob/main/LICENSE)).
- PyTorch: BSD-3-Clause, © Meta Platforms y colaboradores ([licencia](https://github.com/pytorch/pytorch/blob/main/LICENSE)).
- Bibliotecas CUDA de NVIDIA (cuBLAS, cuDNN y otras), solo en las variantes CUDA. Vienen dentro de los wheels CUDA de PyTorch y se redistribuyen bajo el [NVIDIA CUDA EULA](https://docs.nvidia.com/cuda/eula/).
- Cada paquete de modelo indica su propia licencia. Algunos modelos 3D tienen restricciones territoriales o de uso comercial. El panel Modelos muestra las restricciones antes de que se descargue nada.

Atribución requerida: ninguna para este paquete. Los paquetes de modelo indican la suya.

**Restricciones:** ninguna por parte de este paquete. El NVIDIA CUDA EULA permite usar estas bibliotecas junto con la aplicación, pero no redistribuirlas por separado.

Todos los archivos se descargan de sus editores originales (GitHub, el índice de paquetes de Python, download.pytorch.org). AI Game Dev no los aloja.
````
