# Tripo

> 3D na nuvem com a franquia da sua assinatura do AI Game Dev: modelos 3D a partir de texto, de uma imagem ou de várias vistas, texturas, retopologia, divisão em partes, complemento de malha, conversão de formato, rigging, animação e geração e edição de imagens. O agente escolhe a operação e a variante do modelo para cada tarefa.

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

## Instalar

Com o CLI gamedev, na pasta do projeto:

```bash
gamedev pkg add aigd.tripo
```

No app desktop: abra a janela Packages (o ícone de pacote na barra de status), selecione **Browse**, busque `aigd.tripo` 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 |
|---|---|---|---|
| 0.2.20 | 2026-11-22 | `>=0.25.11` | mais recente |
| 0.2.19 | 2026-11-19 | `>=0.25.11` | - |
| 0.2.18 | 2026-11-13 | `>=0.25.11` | - |
| 0.2.17 | 2026-11-06 | `>=0.25.11` | - |
| 0.2.16 | 2026-11-06 | `>=0.25.11` | - |
| 0.2.15 | 2026-11-06 | `>=0.25.11` | - |
| 0.2.14 | 2026-11-05 | `>=0.25.11` | - |
| 0.2.13 | 2026-11-01 | `>=0.25.11` | - |
| 0.2.8 | 2026-10-24 | `>=0.25.10` | - |
| 0.2.7 | 2026-10-15 | `>=0.20.0` | - |
| 0.2.6 | 2026-10-13 | `>=0.20.0` | - |
| 0.2.5 | 2026-10-05 | `>=0.20.0` | - |

## Descrição

````markdown
# Tripo (`aigd.tripo`)

O Tripo conecta o agente do AI Game Dev à geração 3D e de imagens na nuvem do Tripo por meio do servidor do AI Game Dev, paga com a franquia da sua assinatura. Ele cria modelos 3D a partir de texto, de uma imagem ou de várias vistas, gera texturas, processa malhas (retopologia, divisão em partes, complemento de geometria ausente, conversão de formato), faz rigging e animação de modelos, e cria e edita imagens. Nas versões atuais do app, o agente escolhe a operação e a variante do modelo para cada tarefa. O app desktop o instala automaticamente. É indicado para desenvolvedores que querem assets 3D e animação sem uma GPU local.

## O que você pode criar

- Modelos 3D de props, personagens, criaturas e ambientes a partir de um prompt de texto, de uma imagem ou de várias vistas.
- Texturas para um modelo 3D existente.
- Malhas mais limpas: topologia otimizada, modelo dividido em partes, geometria ausente completada ou arquivo convertido para outro formato 3D.
- Personagens com rigging e animação: verificar se um modelo pode receber rigging, adicionar um esqueleto e animá-lo.
- Imagens 2D: a partir de texto, editadas ou como várias vistas de um mesmo objeto (para conversão de múltiplas vistas em 3D).

## Exemplos de solicitações

- "Crie um baú de tesouro de madeira a partir de um prompt de texto com o Tripo e salve-o no projeto."
- "Transforme `Concepts/robot_front.png` em um modelo 3D, depois faça o rigging e adicione uma animação de caminhada."
- "Gere novas texturas para `Assets/Models/house.glb`."
- "Divida este modelo de veículo em partes e otimize sua topologia."
- "Crie vistas de frente, de lado e de costas desta imagem de personagem e depois monte o modelo 3D a partir delas."

## Destaques

|  |  |
|---|---|
| Tipo | pacote de código (ferramentas de sessão para o agente), geração na nuvem |
| 3D | 3D a partir de texto, de uma imagem, de várias vistas |
| Texturas | gerar texturas para um modelo 3D |
| Malha | otimizar topologia, dividir em partes, completar geometria ausente, converter formato de arquivo |
| Rigging e animação | verificar rig, adicionar um esqueleto, animar um modelo com rig |
| 2D | imagem a partir de texto, editar uma imagem, criar e editar várias vistas |
| Custo | percentuais da franquia da sua assinatura, verificados em relação ao orçamento de geração do chat |
| Instalação | automática pelo app desktop |
| Licença | Apache-2.0 (o pacote) |

## Grupos de operações

O desktop instala `aigd.tripo` automaticamente. Seus cinco grupos de operações (3D, Texturas, Malha, Rigging e animação, 2D) não são botões próprios: o grupo **3D** do chat em Tools ativa os quatro primeiros e **Images** ativa o 2D. Quais deles o agente pode usar é decidido apenas na tela Models do projeto.

O agente escolhe a operação e a `variant_id` para cada tarefa entre todas as variantes que o catálogo atual do servidor lista como habilitadas e elegíveis para o plano do usuário; o usuário não as escolhe. Cada chamada verifica novamente o catálogo atualizado e nunca substitui por outro modelo. Uma variante que o plano não inclui fica ausente das ferramentas; `status` e `capability_search` explicam por quê (`PLAN_REQUIRED`: exige um plano superior, que só o usuário pode comprar). As ferramentas não podem alterar configurações da sessão. Isso exige um host que anuncie `env.features.agentChoosesVariants`; em um host mais antigo, o pacote mantém o comportamento anterior (uma variante fixada ou uma lista de permissões explícita de "Agent chooses" escolhida nas configurações de cada grupo). Kernels mais antigos expõem apenas configurações e status.

## Pagamento das tarefas

As operações reais usam a API pública `paidOperations` do Kernel. O Kernel obtém uma cotação imutável do servidor, verifica-a em relação ao orçamento de geração do chat (por padrão, uma tarefa dentro do orçamento é executada sem perguntas; em "Perguntar antes de cada operação", o usuário aprova cada uma) e envia a solicitação aprovada. Uma tarefa que o orçamento não cobre é recusada. A configuração da sessão não é consentimento. Chaves e tokens de conta permanecem fora do pacote; apenas o nosso servidor se comunica com o Tripo.

## Espera, recuperação e novas tentativas

A geração normal aguarda a conclusão e salva todos os artefatos na mesma chamada de ferramenta. Enquanto espera, a chamada segura a recarga de pacotes do app e a atualização do seu serviço em segundo plano (`aigd.work.hold`), para que nenhuma delas substitua o backend no meio da espera. O agente pode recuperar trabalho interrompido com `retrieve_result` ou inspecionar `jobs` e `recover_jobs` para diagnóstico, e revogar a permissão salva. Novas tentativas de download nunca regeram assets. Resultados de envio desconhecidos são recuperados pela identidade de solicitação persistida, em vez de criar uma tarefa substituta. Os arquivos existentes são preservados.

## Contabilização

Todas as estimativas e saldos do cliente usam percentuais da franquia. A contabilização do servidor debita o custo oficial do provedor sem margem adicional. A execução real depende da prontidão atual do servidor, da política de assinatura e do suporte do Kernel. A página de configurações distribuída não contém controles de simulação.

## Validação

A validação cobre alterações de política recentes, propriedade da sessão, negação antes do envio, confirmações perdidas sem novas tentativas e obtenção de artefatos sem geração. Fixtures de desenvolvimento isoladas são auxiliares de QA e não constituem validação do provedor.

## Compatibilidade

Compatibilidade: a ativação verifica as APIs realmente propostas, independentemente da versão do motor. O Kernel anterior de configuração de sessão mantém seus controles legados de webview; o Kernel atual renderiza todos os cinco módulos declarados e gerencia o ciclo de vida deles. Um Kernel sem as APIs básicas de conta/configuração de sessão não registra provedores e registra a exigência de atualização do aplicativo. Esse caminho de compatibilidade nunca substitui uma variante nem autoriza gastos.

## Assets salvos

Cada módulo declara `context.assetOperations` em seu manifesto. O Kernel exibe uma contagem compacta de Assets dentro das configurações desse módulo apenas quando esta sessão tem arquivos de saída concluídos. Abrir revela um popup limitado, nunca um card não solicitado no chat. A lista exclui outros módulos e sessões. Os arquivos salvos abrem no visualizador do projeto ou no gerenciador de arquivos; arquivos ausentes ou alterados podem ser recuperados pelo diário de entrega durável existente, sem repetir a geração paga.
````
