# Runtime local de modelos Python

> Executa modelos locais que não têm port C++ nem ONNX (geração 3D e rigging) com PyTorch neste computador, em um ambiente Python privado por modelo que nunca toca no seu próprio Python. Modelos como TripoSG, Hunyuan3D-2.1 Shape e SkinTokens são pacotes separados.

- Id: `aigd.python`
- Origem: Oficial (de primeira parte `aigd.*`)
- Categoria: 3D
- Publicador: AI Game Dev (`aigd`), verificado
- Versão mais recente: 1.0.2 (publicado em 2026-11-22)
- Licença: MIT
- Requer o app AI Game Dev: `>=0.32.0-beta.6`
- Código nativo: não
- Avaliação: ainda sem avaliações
- Página HTML: https://ai-game.dev/pt-br/packages/aigd.python

## Instalar

Com o CLI gamedev, na pasta do projeto:

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

No app desktop: abra a janela Packages (o ícone de pacote na barra de status), selecione **Browse**, busque `aigd.python` e clique em **Add to Project**. Mais: https://ai-game.dev/docs/wiki/app/packages

## Versões

| Versão | Publicado | Requer o app | Observações |
|---|---|---|---|
| 1.0.2 | 2026-11-22 | `>=0.32.0-beta.6` | mais recente |
| 1.0.1 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## Descrição

````markdown
# Runtime local de modelos Python (`aigd.python`)

O runtime Python local do AI Game Dev: ele executa modelos locais neste computador com [PyTorch](https://pytorch.org), para modelos que não têm port C++ nem ONNX, como image-to-3D, refinamento de malha e auto-rigging. Tudo roda no seu computador e não consome nada da sua cota do AI Game Dev. É indicado para desenvolvedores de jogos que querem transformar concept art em formas 3D ou rigar personagens na própria GPU. Os modelos em si são pacotes separados.

## O que você pode fazer

- Transformar uma única imagem de concept em uma forma 3D com um modelo local de image-to-3D, por exemplo [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) ou [Step1X-3D Geometry](https://ai-game.dev/packages/aigd.model3d-step1x-3d-geometry).
- Rigar a malha de um personagem ou criatura (esqueleto e pesos de skin) com [SkinTokens](https://ai-game.dev/packages/aigd.model3d-skintokens) no Asset Studio.
- Manter sua própria instalação do Python intacta: cada modelo recebe o seu próprio ambiente privado.

## Exemplos de pedidos

- "Transforme `Assets/Concepts/goblin.png` em uma forma 3D com o TripoSG na minha GPU."
- "Faça um modelo 3D desta imagem de baú de tesouro localmente com o Hunyuan3D-2.1 Shape."
- "Transforme `Assets/Concepts/crate.png` em uma forma 3D com o Step1X-3D Geometry."

## Como funciona

Este pacote é somente dados (`aigd-package.json`, sem código). Ele informa ao AI Game Dev qual versão do [uv](https://github.com/astral-sh/uv) baixar para o seu computador. O app usa o uv para montar um ambiente Python privado para cada modelo. **Seu próprio Python nunca é tocado.** Nada é instalado globalmente, nada vai para `PATH` e nada é gravado no registro do Windows. Tudo fica no armazenamento de modelos do app, em `python/`.

## Os modelos são pacotes separados

Este pacote não contém nenhum modelo. Instale um pacote de modelo no navegador de Pacotes e depois baixe os arquivos dele no painel Modelos. Nada é baixado sem a sua confirmação, e você vê o tamanho antes.

Na primeira vez que um modelo é carregado, o app monta o ambiente Python dele. Ele baixa o Python 3.12 e o PyTorch junto com as outras bibliotecas daquele modelo, o que dá de 2 a 4 GB para uma build CUDA. Isso pode levar vários minutos. Os carregamentos seguintes reaproveitam o ambiente. Se um download for interrompido, o próximo carregamento começa de novo e reaproveita todos os arquivos já baixados.

## O que é baixado

- **uv** — versão upstream [`0.13.7`](https://github.com/astral-sh/uv/releases/tag/0.13.7), fixada por sha256. O app escolhe uma variante para o seu computador:

  | Variante | Computador | Download |
  |---|---|---|
  | `win-x64-cuda` | Windows, GPU NVIDIA (driver 572.61 ou mais recente, compute capability 7.0 ou superior) | 15 MB |
  | `win-x64-cpu` | Windows sem uma GPU NVIDIA compatível | 15 MB |
  | `linux-x64-cuda` | Linux x64, GPU NVIDIA (driver 570.124 ou mais recente, compute capability 7.0 ou superior), glibc 2.28 ou mais recente | 17 MB |
  | `linux-x64-cpu` | Linux x64 sem uma GPU NVIDIA compatível, glibc 2.28 ou mais recente | 17 MB |
  | `darwin-arm64-metal` | Mac com Apple silicon, macOS 14 ou mais recente (o PyTorch usa a GPU via MPS) | 14 MB |

  **O Linux é uma prévia.** Ele ainda não foi testado em uma GPU Linux real.
- **Python** 3.12.16 (3.11.18 ou 3.13.18 para um modelo cujas bibliotecas precisem disso): uma build CPython do [python-build-standalone](https://github.com/astral-sh/python-build-standalone). O uv baixa e confere com os checksums embutidos na versão fixada do uv.
- **As bibliotecas Python de cada modelo**: PyTorch 2.11 (CUDA 12.8 em NVIDIA) e as bibliotecas do próprio modelo, do [PyPI](https://pypi.org) e de [download.pytorch.org](https://download.pytorch.org). O app traz a lista exata para cada modelo, fixada por versão e sha256. As instalações usam apenas wheels, então nada é compilado no seu computador. Um arquivo que não corresponda ao seu sha256 interrompe a instalação.

Os modelos rodam offline. Os pesos deles vêm apenas dos arquivos que você baixou no painel Modelos.

## Requisitos

- Cada pacote de modelo informa suas próprias necessidades de GPU e memória de vídeo.
- O app nunca instala drivers nem bibliotecas de sistema. Se o PyTorch não conseguir enxergar sua GPU, o modelo não carrega, e o app avisa para você atualizar o driver NVIDIA.
- AI Game Dev 0.32.0-beta.6 ou mais recente.

## Licença

- Este pacote — 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. A distribuição python-build-standalone também carrega as licenças das bibliotecas que empacota (OpenSSL, SQLite, zlib e outras). Seus scripts de build são MPL-2.0 ([licence](https://github.com/astral-sh/python-build-standalone/blob/main/LICENSE)).
- PyTorch — BSD-3-Clause, © Meta Platforms e colaboradores ([licence](https://github.com/pytorch/pytorch/blob/main/LICENSE)).
- Bibliotecas NVIDIA CUDA (cuBLAS, cuDNN e outras), apenas nas variantes CUDA. Elas vêm dentro dos wheels do PyTorch CUDA e são redistribuídas sob a [NVIDIA CUDA EULA](https://docs.nvidia.com/cuda/eula/).
- Cada pacote de modelo informa sua própria licença. Alguns modelos 3D têm restrições de território ou de uso comercial. O painel Modelos mostra as restrições antes de qualquer download.

Atribuição obrigatória: nenhuma para este pacote. Os pacotes de modelo indicam as suas.

**Restrições:** nenhuma deste pacote. A NVIDIA CUDA EULA permite que essas bibliotecas sejam usadas junto com o aplicativo, mas não redistribuídas separadamente.

Todos os arquivos são baixados dos editores upstream (GitHub, o índice de pacotes do Python, download.pytorch.org). O AI Game Dev não os hospeda.
````
