Esta página foi traduzida automaticamente do inglês. Leia o original em inglês.

Runtime local de modelos Python

Oficial3Dv1.0.2aigd.python
Instalar Ainda sem o app? Baixe grátis
Ou pelo terminal
gamedev pkg add aigd.python

Visã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.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 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:
VarianteComputadorDownload
win-x64-cudaWindows, GPU NVIDIA (driver 572.61 ou mais recente, compute capability 7.0 ou superior)15 MB
win-x64-cpuWindows sem uma GPU NVIDIA compatível15 MB
linux-x64-cudaLinux x64, GPU NVIDIA (driver 570.124 ou mais recente, compute capability 7.0 ou superior), glibc 2.28 ou mais recente17 MB
linux-x64-cpuLinux x64 sem uma GPU NVIDIA compatível, glibc 2.28 ou mais recente17 MB
darwin-arm64-metalMac 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ões de Runtime local de modelos Python
VersãoLançamentoRequer o app
1.0.2Mais recente0.32.0-beta.6 ou mais recente
1.0.10.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.python

Requisitos

  • AI Game Dev 0.32.0-beta.6 ou mais recente

Mais sobre pacotes

Instalar
gamedev pkg add aigd.python