# Instalação — App e CLI do AI Game Dev · AI Game Developer Wiki

Instale o app desktop do AI Game Dev no Windows, macOS ou Linux, ou a CLI gamedev com npm, e mantenha ambos atualizados.

Esta página foi traduzida automaticamente do inglês. [Leia o original em inglês](https://ai-game.dev/docs/wiki/app/installation).

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](https://ai-game.dev/pt-br/docs/wiki/app/sign-in-and-account)).

## Instalar o app desktop

Abra [a página de download](https://ai-game.dev/pt-br/download). Ela detecta o seu sistema e oferece o build correspondente, e lista todos os builds abaixo do botão principal.

| Sistema operacional | Build | Observações |
| --- | --- | --- |
| Windows | Instalador `.exe` assinado, x64 | Roda no Windows on ARM por emulação |
| macOS, Apple silicon | `.dmg` nativo para arm64 | Recomendado para qualquer Mac da série M |
| macOS, Intel | `.dmg` para x64 | Para Macs Intel |
| Linux | AppImage e `.deb`, x86\_64 | Ainda não há build Linux para arm64 |

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](https://ai-game.dev/pt-br/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:

```bash
# 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
```

**Nota**

Você não precisa de Node.js, npm nem das CLIs dos engines para o app desktop. Os instaladores dos plugins de Unity, Unreal e Godot vêm dentro dele.

## 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.

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

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

```bash
cd /path/to/your/game
gamedev
```

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

```bash
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](https://ai-game.dev/pt-br/docs/wiki/app/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](https://ai-game.dev/pt-br/releases).

### Atualizações da CLI

Atualize a CLI com um comando:

```bash
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](https://ai-game.dev/pt-br/docs/wiki/app/packages#updates).

## 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:

```bash
gamedev daemon status
gamedev daemon install
```

Veja a [referência da CLI](https://ai-game.dev/pt-br/docs/wiki/app/cli#daemon) 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](https://ai-game.dev/pt-br/docs/wiki/app/sign-in-and-account) com a sua conta.
- [Abra seu primeiro projeto](https://ai-game.dev/pt-br/docs/wiki/app/projects-and-engines).
- Prefere configurar um plugin de engine manualmente? Veja os guias de instalação dos plugins para [Unity](https://ai-game.dev/pt-br/docs/wiki/unity/installation), [Unreal](https://ai-game.dev/pt-br/docs/wiki/unreal/installation) e [Godot](https://ai-game.dev/pt-br/docs/wiki/godot/installation).

---

Source (HTML): https://ai-game.dev/pt-br/docs/wiki/app/installation

Machine-translated (pt-BR) from the English page: https://ai-game.dev/docs/wiki/app/installation