Aplicativo para desktop

O aplicativo para desktop oferece o mesmo agente, provedores, integrações com a nuvem, projetos e conversas da CLI e do aplicativo web, mas em um aplicativo nativo instalado. O host Tauri inicia o ambiente Python incluído no pacote e carrega a interface local do IaC Code por uma conexão de loopback; nenhum serviço web público é exposto.

Pacotes compatíveis

Baixe o pacote da sua plataforma em GitHub Releases.

Sistema operacional	Arquitetura	Pacote	Forma de atualização
macOS	Apple Silicon	.dmg	Atualização pelo aplicativo
Windows	x64	instalador .exe	Atualização pelo aplicativo
Linux	x64	.AppImage	Atualização pelo aplicativo
Debian / Ubuntu	x64	.deb	Instalação de um pacote mais recente

Cada versão também inclui o arquivo SHA256SUMS, uma lista de materiais de software (SBOM) e os avisos de componentes de terceiros.

Instalação

macOS

1. Baixe e abra o arquivo .dmg, depois arraste o IaC Code para Aplicativos.
2. Abra o IaC Code pela pasta Aplicativos.
3. O pacote atual ainda não tem assinatura Apple Developer ID nem reconhecimento de firma da Apple. Por isso, o macOS pode bloquear a primeira execução. Depois de conferir a soma de verificação, clique no aplicativo mantendo a tecla Control pressionada e escolha Abrir, ou permita a execução em Ajustes do Sistema > Privacidade e Segurança.

Windows

1. Baixe e execute o instalador .exe. O IaC Code é instalado para o usuário atual e cria os atalhos do aplicativo.
2. Se o Microsoft Defender SmartScreen informar que o editor é desconhecido, confira o arquivo SHA256SUMS, selecione Mais informações e só prossiga se a soma for igual à publicada na versão.
3. O pacote inclui o suporte de inicialização do WebView2 necessário para a interface. Na primeira execução, o IaC Code também verifica se o Git Bash está instalado e, caso não esteja, apresenta as instruções de instalação.

Linux AppImage

Dê permissão de execução ao arquivo baixado e execute-o:

chmod +x iac-code_*.AppImage
./iac-code_*.AppImage

Após a primeira execução, o ambiente gráfico pode oferecer a criação de um atalho. A AppImage consegue se atualizar quando houver uma atualização assinada.

Debian ou Ubuntu

Instale o pacote deb com o APT para que as dependências do sistema sejam resolvidas:

sudo apt install ./iac-code_*_amd64.deb

Abra o IaC Code pelo menu de aplicativos. A instalação deb não usa o atualizador interno; para fazer upgrade, baixe e instale o pacote deb mais recente.

Primeira execução

Na primeira vez que é aberto, o IaC Code pede que você escolha uma pasta de projeto. Essa pasta passa a ser o espaço de trabalho usado para acessar arquivos, gerar modelos, executar ferramentas e guardar conversas. Depois, é possível trocar de projeto pelo seletor de projetos.

Se você já usou a CLI ou o aplicativo web, o aplicativo para desktop reaproveita a configuração em ~/.iac-code/ (ou IAC_CODE_CONFIG_DIR), incluindo provedores de modelos, credenciais do Alibaba Cloud, preferências e sessões salvas. Caso contrário, abra Configurações e cadastre um provedor de modelos e as credenciais de nuvem antes de iniciar uma tarefa.

A interface está disponível em inglês, chinês simplificado, japonês, francês, alemão, espanhol e português. O idioma e o tema de cores podem ser alterados em Configurações > Geral.

Atualizações e assinaturas dos pacotes

As versões para macOS, Windows e AppImage consultam periodicamente as informações da versão estável e podem baixar e instalar uma nova versão. Antes da instalação, cada atualização é validada com a chave pública de atualização do IaC Code. O pacote deb segue o processo convencional de pacotes do Linux.

A assinatura de atualização não é a mesma assinatura de editor verificada pelo sistema operacional. A primeira confirma que a atualização foi produzida pelo IaC Code; o reconhecimento de firma do macOS e a assinatura de código do Windows identificam o editor para o sistema. Os instaladores atuais ainda não têm assinatura comercial de editor, portanto os avisos da plataforma são esperados. Sempre baixe os pacotes da página oficial da versão e confira o arquivo SHA256SUMS.

Solução de problemas

• O aplicativo não sai da tela de inicialização: use as ações de recuperação para tentar novamente ou abrir a pasta de diagnóstico. O registro identifica arquivos ausentes no ambiente, uma porta de loopback ocupada ou uma falha ao iniciar o processo auxiliar.
• O Windows informa que o Git Bash não foi encontrado: siga as instruções de instalação, reinicie o IaC Code e refaça a verificação. No Windows, as ferramentas do agente que usam shell dependem do Git Bash.
• O Linux abre o deb como arquivo compactado: instale-o com o comando APT acima, em vez de abri-lo no gerenciador de arquivos compactados.
• Uma pilha ou um link externo não abre no Linux: configure um navegador padrão para a sessão gráfica e tente novamente.
• As configurações ou sessões não são compartilhadas com a CLI: confirme que os dois aplicativos usam o mesmo valor de IAC_CODE_CONFIG_DIR e são executados pelo mesmo usuário do sistema.

Para saber como instalar e usar a CLI, consulte Instalação e Uso da CLI. Para a interface no navegador, consulte o Aplicativo web.