3.2. Instalação do app

Instale o Naia como um aplicativo autônomo em seu sistema operacional existente. Todos os arquivos de instalação estão disponíveis na página de Download ou itch.io.

Windows (Recomendado — Instalador)

Requisitos do sistema

• OS: Windows 10 / Windows 11 (x64)
• Runtime: WebView2 (incluído automaticamente se o Edge estiver instalado)

Instalação

1. Baixe Naia-Shell-x86_64-setup.exe na página de download
2. Clique duas vezes no arquivo para iniciar o assistente de instalação
3. Selecione seu idioma (coreano/inglês) e siga as instruções
4. Inicie o Naia pela área de trabalho ou menu Iniciar

Atualização automática: Quando uma nova versão for lançada, aparecerá uma notificação. Confirme para atualizar automaticamente.

Pacote MSI (Administradores de TI)

Para implantação empresarial ou instalação via Política de Grupo, use o pacote .msi:

msiexec /i Naia-Shell-x86_64.msi /quiet

Linux (Flatpak recomendado)

Requisitos do Sistema

• OS: Linux (Ubuntu, Fedora, Bazzite, etc.)
• Monitor: Wayland (recomendado) ou X11
• A instalação Flatpak não requer configuração de tempo de execução adicional.

Flatpak (Recomendado)

A forma mais segura de instalar. O aplicativo é executado em seu próprio espaço isolado — seu sistema permanece limpo.

Baixe o pacote .flatpak da página de Download e instale via terminal:

flatpak install --user ./Naia-Shell-x86_64.flatpak

Como funciona: O Naia é executado em um espaço isolado por segurança. Quando a IA precisa controlar seu PC, ele solicita apenas as permissões necessárias.

Outros Formatos

AppImage, DEB (Debian/Ubuntu), e RPM (Fedora/RHEL) também estão disponíveis na página de Download.

(Para Desenvolvedores) Guia de Construção Local Flatpak

Para construir o aplicativo sandbox Flatpak a partir do código-fonte, siga estas etapas:

1. Instalar o Flatpak Builder

   Copy

   # Fedora / Bazzite
   sudo dnf install flatpak-builder
   
   # Ubuntu
   sudo apt install flatpak-builder
   

2. Adicionar Dependências de Construção (SDK)

   Copy

   flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
   flatpak install --user flathub org.gnome.Platform//50 org.gnome.Sdk//50 org.freedesktop.Sdk.Extension.rust-stable//25.08 org.freedesktop.Sdk.Extension.node22//25.08 org.freedesktop.Sdk.Extension.llvm20//25.08
   

3. Executar a Construção do Pacote Execute isso no diretório raiz do projeto (Naia-OS).

   Copy

   # Compila e constrói no build-dir
   flatpak-builder --user --install --force-clean build-dir flatpak/io.nextain.naia.yml
   

4. Executar o Aplicativo

   Copy

   flatpak run com.naia.shell
   

Nota do Desenvolvedor: Para manipular o ambiente host do usuário de dentro do sandbox Flatpak, o agente de IA internamente envolve todas as requisições da ferramenta execute_command com flatpak-spawn --host bash -c ... em agent/src/gateway/tool-bridge.ts.