3.2. Linux App Installation

Install Naia as a standalone app on your existing OS. All installation files are available on the Download page or itch.io.

Windows (Recommended — Installer)

System Requirements

• OS: Windows 10 / Windows 11 (x64)
• Runtime: WebView2 (automatically included if Edge is installed)
• Node.js: No separate installation required (the Naia installer bundles the required runtime)

Installation

1. Download Naia-Shell-x86_64-setup.exe from the Download page
2. Double-click the file to launch the setup wizard
3. Select your language (Korean/English) and follow the prompts
4. Launch Naia from the desktop or Start Menu

Auto-update: When a new version is released while the app is running, you'll see a notification. Confirm to update automatically.

Node.js note: Installed-app users do not need to install Node.js or configure its path. Node.js 22 or later is required only when developing or building Naia from source.

Microphone permission on first use

When you first use a voice or microphone feature, Windows WebView2 may ask whether localhost can access your microphone. Here, localhost means the Naia app screen running locally on your PC, not an external website.

• Select Allow to use voice conversations.
• Text chat remains available if you select Block.
• To change this later, enable microphone access in Windows Settings > Privacy & security > Microphone.

MSI Package (IT Administrators)

For enterprise deployment or Group Policy installation, use the .msi package:

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

Linux (Flatpak Recommended)

System Requirements

• OS: Linux (Ubuntu, Fedora, Bazzite, etc.)
• Display: Wayland (recommended) or X11
• Flatpak installation requires no additional runtime setup.

Flatpak (Recommended)

The most secure way to install. The app runs in its own isolated space — your system stays clean.

Download the .flatpak bundle from the Download page and install via terminal:

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

How it works: Naia runs in an isolated space for safety. When the AI needs to control your PC, it requests only the necessary permissions.

Other Formats

AppImage, DEB (Debian/Ubuntu), and RPM (Fedora/RHEL) are also available on the Download page.

(For Developers) Local Flatpak Build Guide

To build the Flatpak sandbox app from the source code, follow these steps:

1. Install Flatpak Builder

   Copy

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

2. Add Build Dependencies (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. Run the Packaging Build Execute this in the project root directory (Naia-OS).

   Copy

   # Compiles and builds into the build-dir
   flatpak-builder --user --install --force-clean build-dir flatpak/io.nextain.naia.yml
   

4. Run the App

   Copy

   flatpak run com.naia.shell
   

Developer Note: To manipulate the user's host environment from inside the Flatpak sandbox, the AI agent internally wraps all execute_command tool requests with flatpak-spawn --host bash -c ... in agent/src/gateway/tool-bridge.ts.