Skip to main content
Source Code: src/gaia/apps/webui/ | src/gaia/ui/

​
Overview

The GAIA Agent UI is distributed as an npm package and can also be packaged as an Electron desktop app for Windows and Ubuntu.

Agent UI Guide

Features, keyboard shortcuts, troubleshooting, and architecture.

Agent UI SDK

Python backend API: FastAPI server, SQLite database, Pydantic models, and SSE streaming.

Custom Installer

Ship a branded GAIA build with your agent pre-loaded.

​
Installation

Prebuilt desktop installers (.exe / .deb) are being rolled out. To use the Agent UI today, install via npm (launcher binary is gaia-ui):
npm install -g @amd-gaia/agent-ui
gaia-ui
Or launch from the GAIA CLI: gaia --ui. See the Agent UI guide for details.
Install GAIA UI on Windows and Ubuntu using the packages from the GitHub Releases page (when available). Artifact names follow gaia-agent-ui-<version>-<arch>-setup.<ext> (see electron-builder.yml).

​
Supported platforms

  • Windows 11 (64-bit) - Full GUI and CLI support
  • Linux: Ubuntu 22.04 LTS or 24.04 LTS (64-bit) - Full GUI and CLI support

​
Windows (.exe)

  1. Download gaia-agent-ui-<version>-x64-setup.exe (e.g. gaia-agent-ui-0.17.2-x64-setup.exe) from Releases.
  2. Double-click the installer and follow the prompts.
  3. Launch GAIA from the Start Menu (search for “GAIA”) or the desktop shortcut. The underlying binary is gaia-desktop.
  4. On first launch, setup may take a moment. An internet connection is required the first time.
  5. Updating: download the newer gaia-agent-ui-<version>-x64-setup.exe from Releases and run it.
  6. Uninstalling: Windows Settings → Apps → Installed apps → find “GAIA” → Uninstall.

​
Ubuntu (.deb)

  1. Download gaia-agent-ui-<version>-amd64.deb (e.g. gaia-agent-ui-0.17.2-amd64.deb) from Releases.
  2. Open a terminal in the download folder, then install with apt:
sudo apt update
sudo apt install ./gaia-agent-ui-*-amd64.deb
  1. Launch GAIA from your application menu (search for “GAIA”) or run gaia-desktop from a terminal.
  2. On first launch, setup may take a moment. An internet connection is required the first time.
  3. Updating: download the newer .deb from Releases and reinstall with apt (same command as above).
  4. Uninstalling (package name is gaia-desktop):
sudo apt remove gaia-desktop

​
Ubuntu (.AppImage)

Both the AppImage and the .deb ship with --no-sandbox to work around Ubuntu 24.04.1+‘s AppArmor-restricted unprivileged-userns policy (kernel.apparmor_restrict_unprivileged_userns=1), which otherwise aborts Chromium with a FATAL sandbox error on first launch — see the security note in Troubleshooting → AppImage on Linux. Use the AppImage for portable installs or distros without apt.
Ubuntu 24.04 LTS minimal does not ship the FUSE 2 runtime or the Chromium system libraries that the AppImage bundles. Install them first:
sudo apt install libfuse2 libglib2.0-0t64 libgtk-3-0t64 libnss3 \
    libasound2t64 libxss1 libxtst6 libatk-bridge2.0-0t64 libgbm1
  1. Download gaia-agent-ui-<version>-x86_64.AppImage from Releases.
  2. Make it executable and run:
chmod +x gaia-agent-ui-*.AppImage
./gaia-agent-ui-*.AppImage
  1. On Ubuntu 24.04.1+, the AppImage runs with --no-sandbox by default to work around the distro’s AppArmor userns restriction. See Troubleshooting → AppImage on Linux for the security implications and recovery steps.
  2. To collect logs for a bug report:
gaia diagnostics
Attach the resulting ~/.gaia/diagnostics-*.tgz to your GitHub issue.

​
GAIA Chat (Lightweight Desktop)

GAIA Chat is a lightweight, privacy-first desktop chat application built with a Python FastAPI backend and a minimal web frontend. It is designed as a lighter alternative to RAUX, focused specifically on chat and document Q&A.

​
Key Features

  • Privacy-first: All data stays local — no cloud, no telemetry
  • Document Q&A: Drag-and-drop 50+ file formats for RAG-powered search
  • Session management: Create, rename, export, and delete conversations
  • Streaming responses: Real-time SSE streaming from local LLMs
  • Shared CLI/UI state: Same SQLite database as gaia chat CLI
  • Modern frontend: React + TypeScript SPA with Zustand state management

​
Architecture

GAIA Chat Desktop
  Electron Shell (optional) or Browser
    |
    v
  FastAPI Backend (Python, port 4200)
    - REST API + SSE streaming
    - SQLite database (WAL mode)
    |
    v
  GAIA Core SDKs
    - AgentSDK, RAGSDK, LemonadeClient
    |
    v
  Lemonade Server (port 8000)

​
Developer Quick Start

# 1. Start Lemonade Server
lemonade-server serve

# 2. Start Agent UI backend
python -m gaia.ui.server

# 3. Open http://localhost:4200 in your browser
For full documentation, see:

​
GAIA UI (RAUX) Interface

GAIA UI (also referred to as RAUX for RyzenAI User Experience) is a modern Electron-based desktop application that provides the primary interface for GAIA. Built as a fork from Open-WebUI, it delivers an extensible, feature-rich, and user-friendly AI platform experience. GAIA UI is actively developed with regular feature updates and improvements.

​
New in GAIA UI (RAUX)

  • Improved error handling and progress reporting via inter-process communication (IPC) between the main and renderer processes.
  • Unified GAIA UI branding and updated messaging throughout the installer and UI.

​
🙏 Acknowledgments: RAUX & OpenWebUI

​
Built on OpenWebUI Foundation

RAUX (RyzenAI UX) is built upon the excellent foundation provided by OpenWebUI, an outstanding open-source project that has revolutionized how users interact with AI models through web interfaces.

​
Special Thanks

We extend our heartfelt gratitude to:
  • Timothy Jaeryang Baek and the entire OpenWebUI team for creating and maintaining such an exceptional open-source project
  • The OpenWebUI community for their continuous contributions, feedback, and innovation
  • All open-source contributors who have helped shape the modern AI interface landscape

​
Open Source Heritage

GAIA UI builds upon OpenWebUI’s solid architectural foundation while adding AMD-specific optimizations and integrations tailored for the GAIA ecosystem. This collaboration exemplifies the power of open-source software in advancing AI accessibility and user experience. The OpenWebUI project’s commitment to creating intuitive, powerful, and extensible AI interfaces has made GAIA UI possible. Learn more about OpenWebUI: https://github.com/open-webui/open-webui
For more information about GAIA UI (RAUX), including setup instructions and feature documentation, please refer to the RAUX GitHub repository README.

​
License

MIT License Copyright(C) 2024-2026 Advanced Micro Devices, Inc. All rights reserved. SPDX-License-Identifier: MIT