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)

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.

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.