3.2. App-Installation

Installieren Sie Naia als eigenständige App auf Ihrem bestehenden Betriebssystem. Alle Installationsdateien sind auf der Download-Seite oder bei itch.io verfügbar.

Windows (Empfohlen — Installationsprogramm)

Systemanforderungen

• OS: Windows 10 / Windows 11 (x64)
• Laufzeit: WebView2 (automatisch enthalten, wenn Edge installiert ist)

Installation

1. Laden Sie Naia-Shell-x86_64-setup.exe von der Download-Seite herunter
2. Doppelklicken Sie auf die Datei, um den Einrichtungsassistenten zu starten
3. Wählen Sie Ihre Sprache (Koreanisch/Englisch) und folgen Sie den Anweisungen
4. Starten Sie Naia vom Desktop oder Startmenü

Automatisches Update: Wenn eine neue Version veröffentlicht wird, erscheint eine Benachrichtigung. Bestätigen Sie, um automatisch zu aktualisieren.

MSI-Paket (IT-Administratoren)

Für Unternehmensbereitstellung oder Gruppenrichtlinieninstallation verwenden Sie das .msi-Paket:

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

Linux (Flatpak empfohlen)

Systemanforderungen

• Betriebssystem: Linux (Ubuntu, Fedora, Bazzite, etc.)
• Anzeige: Wayland (empfohlen) oder X11
• Die Flatpak-Installation erfordert keine zusätzliche Laufzeitkonfiguration.

Flatpak (Empfohlen)

Die sicherste Art der Installation. Die App läuft in ihrem eigenen isolierten Bereich – Ihr System bleibt sauber.

Laden Sie das .flatpak-Bundle von der Download-Seite herunter und installieren Sie es über das Terminal:

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

So funktioniert es: Naia läuft aus Sicherheitsgründen in einem isolierten Bereich. Wenn die KI Ihren PC steuern muss, fordert sie nur die notwendigen Berechtigungen an.

Andere Formate

AppImage, DEB (Debian/Ubuntu) und RPM (Fedora/RHEL) sind ebenfalls auf der Download-Seite verfügbar.

(Für Entwickler) Lokale Flatpak-Build-Anleitung

Um die Flatpak-Sandbox-App aus dem Quellcode zu erstellen, befolgen Sie diese Schritte:

1. Flatpak Builder installieren

   Copy

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

2. Build-Abhängigkeiten hinzufügen (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. Den Packaging Build ausführen Führen Sie dies im Stammverzeichnis des Projekts (Naia-OS) aus.

   Copy

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

4. Die App ausführen

   Copy

   flatpak run com.naia.shell
   

Entwicklerhinweis: Um die Host-Umgebung des Benutzers aus der Flatpak-Sandbox heraus zu manipulieren, umschließt der KI-Agent intern alle execute_command-Tool-Anfragen mit flatpak-spawn --host bash -c ... in agent/src/gateway/tool-bridge.ts.