Instalação

Esta página mostra como instalar o app desktop do AI Game Dev e a CLI gamedev, quais builds existem para cada sistema operacional e como funcionam as atualizações. Ambos são gratuitos para baixar; o que o agente pode fazer depende do seu plano (veja Login e conta).

Instalar o app desktop#

Abra a página de download. Ela detecta o seu sistema e oferece o build correspondente, e lista todos os builds abaixo do botão principal.

Não existe binário universal para macOS: escolha o build para Apple silicon ou para Intel. Se o seu navegador não informa a arquitetura do seu Mac (Safari e Firefox não informam), a página mostra os dois builds e deixa você escolher.

Windows#

1. Baixe o instalador na página de download.
2. Execute o .exe e siga o instalador.
3. Inicie o AI Game Dev pelo menu Iniciar.

macOS#

1. Baixe o .dmg para o seu Mac (Apple silicon ou Intel).
2. Abra-o e arraste o app para Aplicativos.
3. Inicie o app em Aplicativos ou no Launchpad.

Linux#

Use o .deb em sistemas baseados em Debian e Ubuntu, ou o AppImage em qualquer outro:

# Debian / Ubuntu: use the name of the file you downloaded
sudo apt install ./<downloaded-file>.deb

# Any distribution: make the AppImage executable, then run it
chmod +x ./<downloaded-file>.AppImage
./<downloaded-file>.AppImage

Instalar a CLI gamedev#

A CLI gamedev é o mesmo agente no seu terminal. Ela é publicada no npm como @baizor/gamedev e instala um binário pré-compilado autocontido para a sua plataforma: Windows x64, macOS arm64 e x64, Linux x64 e arm64.

Requisitos: Node.js 22 ou mais recente com npm.

npm install -g @baizor/gamedev
gamedev --version

Depois vá até o seu projeto de jogo e inicie-o:

cd /path/to/your/game
gamedev

Você também pode executá-la uma vez sem instalação global:

npx @baizor/gamedev

Na primeira execução, a CLI pede que você faça login. A lista completa de comandos está na referência da CLI.

Atualizações#

Atualizações do app desktop#

O app desktop verifica atualizações por conta própria. Quando uma nova versão está disponível, ele a baixa em segundo plano e mostra Restart to update; a atualização é instalada quando você reinicia. Você também pode verificar manualmente em Settings, About, que mostra a versão do app e o estado da atualização.

O que mudou em cada versão está na página de notas de versão.

Atualizações da CLI#

Atualize a CLI com um comando:

gamedev update

Isso executa npm install -g @baizor/gamedev@latest para você. Dentro da CLI interativa, /update explica como atualizar e mostra o estado do serviço em segundo plano; /update now substitui um serviço em segundo plano que está aguardando atualização.

Atualizações de pacotes#

Pacotes, como o Blender ou a Knowledge Base, são atualizados separadamente do app: eles são verificados na inicialização e a cada quatro horas, e você pode desativar as atualizações automáticas por pacote. Veja Pacotes.

O serviço em segundo plano#

O app desktop, a CLI e o gamedev acp se conectam todos a um único serviço em segundo plano do AI Game Dev no seu computador. Ele é dono do seu login, chats, pacotes e arquivos de projeto, então um chat continua rodando se você fechar o terminal que o iniciou. Normalmente você nunca mexe nele. Para um computador que deve permanecer acessível a partir dos seus outros dispositivos, a CLI pode instalá-lo como um serviço do sistema operacional por usuário que inicia no login:

gamedev daemon status
gamedev daemon install

Veja a referência da CLI para os outros subcomandos de daemon.

O que é instalado e onde#

• O app mantém sua configuração, login e cache de pacotes na pasta .ai-game-dev no seu diretório home (~/.ai-game-dev/).
• Um projeto só recebe uma pasta .ai-game-dev/ quando algo é armazenado no nível do projeto, por exemplo um pacote adicionado para a equipe toda ou notas da Knowledge Base.
• Modelos de IA locais são armazenados em uma pasta de armazenamento de modelos que você pode mover para outro disco em Settings, Model storage (ou com /images storage na CLI).

Próximos passos#

• Faça login com a sua conta.
• Abra seu primeiro projeto.
• Prefere configurar um plugin de engine manualmente? Veja os guias de instalação dos plugins para Unity, Unreal e Godot.