UI Documentation

Source Code: src/gaia/apps/ | RAUX Repository

Table of Contents

• GAIA UI Documentation
  • Table of Contents
• UI Overview
• Qt Interface
  • Prerequisites
  • Using Qt Designer
    • Launching Qt Designer
    • Editing the UI
    • Working with Assets
  • Compiling Changes
  • Troubleshooting
• GAIA UI Interface
  • New in GAIA UI (RAUX)
• License

UI Overview

GAIA provides a single modern user interface:

• GAIA UI (RAUX) - A modern Electron-based desktop application providing an intuitive interface for GAIA

Installation

Install GAIA UI on Windows and Ubuntu using the packages from the GitHub Releases page.

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 the latest gaia-ui-setup.exe from Releases.
2. Double-click gaia-ui-setup.exe and follow the prompts.
3. Launch GAIA UI from the Start Menu (search for “GAIA UI”) or the desktop shortcut.
4. On first launch, setup may take a moment. An internet connection is required the first time.
5. Updating: download the newer gaia-ui-setup.exe from Releases and run it.
6. Uninstalling: Windows Settings → Apps → Installed apps → find “GAIA UI” → Uninstall.

Ubuntu (.deb)

1. Download the latest gaia-ui-setup.deb (amd64) from Releases.
2. Open a terminal in the folder where you downloaded gaia-ui-setup.deb, then install with apt:

sudo apt update
sudo apt install ./gaia-ui-setup.deb

3. Launch GAIA UI from your application menu (search for “GAIA UI”).
4. On first launch, setup may take a moment. An internet connection is required the first time.
5. Updating: download the newer gaia-ui-setup.deb from Releases and install it again with apt (same command as above).
6. Uninstalling:

sudo apt remove gaiaui

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-2025 Advanced Micro Devices, Inc. All rights reserved. SPDX-License-Identifier: MIT

---