Runtime local de modelos Python
gamedev pkg add aigd.pythonVisão geral
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.
O runtime Python local do AI Game Dev: ele executa modelos locais neste computador com PyTorch, 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, Hunyuan3D-2.1 Shape ou Step1X-3D Geometry.
- Rigar a malha de um personagem ou criatura (esqueleto e pesos de skin) com 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.pngem 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.pngem 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 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, 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. 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 e de 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, Apache-2.0).
- CPython — PSF License 2.0, © 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).
- PyTorch — BSD-3-Clause, © Meta Platforms e colaboradores (licence).
- 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.
- 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.
Versões
| Versão | Lançamento | Requer o app |
|---|---|---|
| 1.0.2Mais recente | 0.32.0-beta.6 ou mais recente | |
| 1.0.1 | 0.32.0-beta.6 ou mais recente |
Instalar
No app para desktop
Abra a janela Pacotes (o ícone de pacote na barra de status), selecione Explorar, pesquise aigd.python e clique em Adicionar ao projeto.
Ainda sem o app? Baixe o AI Game Dev grátis para Windows, macOS ou Linux.
Pelo terminal
Com a CLI gamedev, na pasta do seu projeto:
gamedev pkg add aigd.pythonRequisitos
- AI Game Dev 0.32.0-beta.6 ou mais recente
gamedev pkg add aigd.python