v0.9.0

GAIA v0.9.0 Release Notes

Released: July 1, 2025

🚀 Major Changes

Broader Hardware Support (#705)

• Removed CPU restrictions: Eliminated AMD Ryzen AI 300-series processor requirement
• GGUF model support: GAIA now supports GGUF models via Lemonade Server with llama.cpp/Vulkan backends (CPU and iGPU only). Any GGUF model can be added via the Lemonade Model Management dashboard via the Lemonade tray icon.
• Universal compatibility: GAIA can now be installed on most Ryzen processor

Architecture Simplification (#672)

• Removed Legacy GUI components: Stripped out the entire gaia.interface module and associated web servers to streamline and simplify the codebase. New use-cases and functional CLI will be added in a future release.
• Agent-first approach: Preparing for new agent use-cases starting with Blender Agent

🛠️ Installer Improvements

Enhanced Installation Process

• Simplified Lemonade verification: Replaced complex post-installation version checking with reliable installer exit code validation
• Fixed PATH refresh issues: Eliminated problematic environment refresh attempts that caused false failures
• Simplified installer flow: Removed hardware compatibility warning dialogs
• Comprehensive logging: Added timestamped logging to gaia_install.log for better debugging

🔧 CI/CD Enhancements

Workflow Permissions (#696)

• Added missing contents: write permission to publish_installer workflow
• Fixed potential failures in the installer publishing process

Centralized Version Management (#695)

• Single source of truth: Centralized LEMONADE_VERSION = "8.0.3" in src/gaia/version.py
• Eliminated version mismatches: Removed hardcoded versions from installer and CI
• Reusable CI action: Created .github/actions/install-lemonade/action.yml for consistent Lemonade installation
• Enhanced CI features: Added Windows Defender exclusions and verification

🐛 Bug Fixes

Lemonade Integration

• Version compatibility (#686): Improved version checking with better error handling and user messaging
• Factory test fixes (#687): Resolved issues with factory testing procedures

Documentation

• README fixes (#702, #684): Corrected labels and icon references
• Nimbys documentation (#700): Fixed miniforge installation workflow documentation

🔄 Dependencies

• Lemonade Server: Updated to version 8.0.3, release details here.
• RAUX: Updated to v0.6.5+raux.0.2.2

📋 Breaking Changes

• GUI Removal: The entire gaia.interface module has been removed. Users should transition to using RAUX UI for graphical interaction

v0.8.8

GAIA Release Notes: v0.8.6 to v0.8.8

Release Summary

• Upgraded to Lemonade v8.0.1
• Enhanced version compatibility checking
• Improved version parsing for development builds

What's New in Lemonade v8

• Llama.cpp/Vulkan support
• Usage statistics in completions and chat/completions endpoints
• Performance optimizations for faster response times
• System Tray - Native desktop integration
• HuggingFace Models - Direct GGUF model access

v0.8.6

GAIA Release Notes: v0.8.5 to v0.8.6

Release Summary

• Update RAUX to v0.6.5+raux.0.2.1
• RAUX introduced internal updates and Lemonade indicator

Full Changelog: v0.8.5...v0.8.6

v0.8.5

GAIA Release Notes: v0.8.4 to v0.8.5

Release Summary

• Upgrade Lemonade to v7.0.4 for solving a bug that caused a halt in model generation when the health check endpoint was called externally
• Added fix for Blender notebook integration

Full Changelog: v0.8.4...v0.8.5

v0.8.4

GAIA Release Notes: v0.8.2.1 to v0.8.4

Release Summary

This release of GAIA focuses on three key areas:

1. Desktop Application Integration: Introduction of GAIA BETA through comprehensive ElectronJS-based RAUX integration, providing a professional desktop experience with streamlined installation and native window management.
2. Installation Reliability: Major improvements to the installation process with enhanced error handling, better environment variable management, and resolution of critical compatibility issues that affected user onboarding.
3. Backend Infrastructure: Core improvements to agent frameworks, memory management, and system stability.

---

🚀 New: GAIA BETA Desktop Application

Professional Desktop Experience

• ElectronJS-based RAUX Integration: Complete desktop application with native window management, professional loading screens, and status monitoring
• Streamlined Installation: Direct RAUX installer download and execution with real-time progress tracking
• Version Management: Automatic version detection and compatibility checking between GAIA and RAUX components

Enhanced User Interface

• Modern Loading Experience: Professional loading screens with animated progress indicators and real-time status updates
• Native Desktop Features: Full desktop application behavior with proper window management and system integration
• Installation Status Monitoring: Comprehensive real-time feedback during RAUX installation and configuration

---

🔧 Installation & Setup Improvements

Reliability Enhancements

• Environment Variable Management: Improved handling of system environment variables during installation
• Error Recovery: Enhanced error handling and recovery mechanisms for failed installations
• Compatibility Checks: Better validation of system requirements and dependencies

User Experience

• Installation Feedback: Real-time progress updates and detailed status information during setup
• Error Reporting: Clear error messages and suggested resolution steps for common issues
• Cross-Platform Support: Improved compatibility across different Windows configurations

---

🏗️ Backend & Infrastructure

Agent Framework

• Core Agent Improvements: Enhanced base agent functionality and error handling
• Memory Management: Improved memory allocation and cleanup for long-running processes
• System Stability: Various fixes for edge cases and error conditions
• New Blender Agent: Added support for the Blender agent, enabling advanced 3D workflow automation and integration with Blender-based pipelines.

Developer Experience

• Build System: Improvements to the build and packaging process
• Documentation: Updated installation guides and troubleshooting documentation
• Testing: Enhanced test coverage for critical installation paths

---

🔄 Migration & Compatibility

• Backward Compatibility: Existing GAIA installations continue to work as before
• Optional Integration: GAIA BETA is available as an optional desktop experience
• Seamless Transition: Easy migration path from command-line to desktop usage

---

🙏 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

RAUX 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 BETA possible.

Learn more about OpenWebUI: https://github.com/open-webui/open-webui

v0.8.2.1

What's Changed

• Fix typo in README.md by @YJMSTR in #47
• Remove bad package install by @itomek in #50

New Contributors

• @YJMSTR made their first contribution in #47
• @itomek made their first contribution in #50

Full Changelog: v0.8.2...v0.8.2.1

v0.8.2

GAIA Release Notes: v0.7.4 to v0.8.2

Release Summary

This release of GAIA focuses on three key areas:

1. Installation Experience: Consolidated installation process with a single unified installer that adapts to different hardware configurations, improved CPU compatibility detection, and replacement of Conda with an embedded Python distribution for simpler setup.

2. AI Capabilities Enhancement: Major improvements to RAG (Retrieval-Augmented Generation) systems for better document processing, support for new models through Ollama integration, and enhanced evaluation frameworks for measuring AI response quality.

3. User Experience Improvements: Introduction of RAUX (an OpenWebUI fork built for GAIA) providing a new user interface for interacting with GAIA, along with improved support for AMD Ryzen AI processors. NOTE: RAUX is currently disabled but will be enabled in the next release (v0.8.3).

🚀 Major Features

• RAUX Integration (#504) - Integrated RAUX, a customized fork of OpenWebUI built specifically for GAIA. This new user interface improves the experience of interacting with GAIA's AI models and provides a more intuitive way to leverage GAIA's capabilities.

• RAG Improvements (#505) - Enhanced the Retrieval-Augmented Generation system with structured HTML content extraction, improved document loading, and better error handling. These changes provide more accurate and relevant responses when users query documents or knowledge bases.

• RAG Evaluator Framework (#399) - Added a comprehensive evaluation system that measures RAG output quality using ground truth generation, vector-based document indexing (using BAAI/bge-base-en-v1.5 embeddings), and similarity analysis. This helps developers improve document retrieval accuracy and response quality.

• Lemonade Client API (#501) - Introduced a new client API that abstracts server details, including mock implementations for testing. This API simplifies integration of GAIA's AI capabilities into other applications and services.

• Ollama Models Support (#546) - Added support for Ollama's model ecosystem with improved download handling and configuration. Now includes Gemma and Qwen series models, expanding the range of AI models available to GAIA users.

• Single Unified Installer (#507) - Created a more user-friendly installation process that automatically adapts to the user's hardware. The installer detects CPU capabilities, offers appropriate installation options, and provides a streamlined setup experience.

• Hybrid Model Settings (#513) - Fixed configuration issues between development workflow and UI installations to ensure consistent behavior when using hybrid AI models (models that use both CPU and GPU acceleration).

🐛 Bug Fixes

• Ollama Backend in Hybrid Mode (#524) - Fixed intermittent connection issues with Ollama models in hybrid configurations by implementing proper settings synchronization and backend detection logic.

• TTS Threading (#544) - Resolved thread safety issues in the Text-to-Speech component by improving initialization and state management, preventing crashes during voice interactions.

• Qwen Model Formatting (#514) - Fixed critical errors when using Qwen models by adding proper system messages and refactoring prompt handling to ensure consistent formatting.

• GitHub Bug Request System (#548) - Improved templates for bug reporting and pull requests to make the contribution process more accessible and ensure necessary information is collected.

• Version Reporting (#549) - Fixed inconsistencies in how version information is reported during the installation process.

• CI Pipeline Stability (#508) - Enhanced continuous integration reliability by pinning NumPy to version 1.26.4 and adding verification steps in the testing workflow.

• CLI Testing Environment (#556) - Prevented unintended Conda environment modifications during command-line interface tests.

🔧 Installation Improvements

• Embedded Python (#542, #581) - Replaced Conda dependency with an embedded Python 3.11.x distribution, introducing a simplified launch script (launch_gaia.bat) and making the installation process more reliable and self-contained.

• Miniforge Migration (#562) - Updated all conda-related paths and initialization scripts in GitHub Actions workflows to use Miniforge instead of Miniconda, improving compatibility with AMD hardware.

• RAUX Installation Process (#565) - Improved the installer with updated naming conventions and enhanced logging for RAUX components, providing a more reliable setup experience for GPU acceleration.

• Auto-Publishing System (#497) - Implemented automated publishing of installer packages to GitHub releases, ensuring users always have access to the latest verified builds without manual intervention.

• Command Line Configuration (#609) - Added support for the GAIA_MODE environment variable (HYBRID, GENERIC, NPU) and convenient shortcut flags (--hybrid, --generic) to simplify command-line usage and server configuration.

• RAUX Version Management (#509) - Added versioning support for RAUX components and improved dependency verification to ensure compatibility between components.

• Hardware Compatibility Warnings (#517) - Added clear warnings when installing on systems without AMD Ryzen AI 300-series processors, helping users understand hardware requirements and providing guidance on appropriate installation options.

• Lemonade v6 Support (#493) - Added support for the latest version of the Lemonade inference engine, enabling RAUX integration and bringing performance improvements.

📝 Documentation

• README Enhancements (#506, #553) - Added introduction video, clarified hardware requirements for different operating modes, and created a comprehensive troubleshooting section to help new users get started.

• Installation Guide Updates (#595) - Revised the development setup documentation to reflect the move from Miniconda to Miniforge, with clear PATH configuration instructions and guidance on driver installation verification.

• Downloads Statistics (#594) - Added a GitHub downloads counter badge to track adoption and popularity of GAIA releases.

• Contribution Templates (#555) - Updated the pull request template and driver version information (to 32.0.203.251) to streamline the contribution process and avoid compatibility warnings.

🛠️ Maintenance & Infrastructure

• Version Management System (#527, #496) - Implemented a centralized approach using importlib.metadata, improving version reporting in the CLI and standardizing the format to v{version}+{hash} for better tracking.

• Lemonade Engine Update (#580) - Updated the Lemonade inference component to version 6.2.0, bringing performance improvements and ensuring compatibility with the RAUX user interface.

• Input Processing Improvements (#596) - Enhanced input handling with null checks in the Agent class and role-specific templates in the Prompts class for more reliable user interactions.

• Contribution Workflow (#526, #528) - Added standardized issue templates for bug reports and feature requests to improve the quality of community contributions.

• License Compliance (#551) - Added proper copyright notices for Advanced Micro Devices, Inc. (2024-2025) and MIT license identifiers to ensure legal compliance.

• Agent System Cleanup (#502) - Removed unused agent code and streamlined the architecture to improve maintainability and performance.

• RAUX Configuration Controls (#608) - Added mechanisms to temporarily disable RAUX functionality when needed for troubleshooting or compatibility testing.

• Launch Configuration (#545) - Enhanced the launch.json configuration with background execution arguments and improved formatting for chat interactions.

• CI Testing Environment (#526) - Configured continuous integration to use specifically the 240 driver for consistent test results across different environments.

• Component Renaming (#500) - Updated the Lemonade server component name for consistency and preparation for version 6 integration.

• Dependency Flexibility (#451) - Relaxed Pydantic version constraints to improve compatibility with other Python packages and reduce installation conflicts.

• Release Process Automation (#371) - Added a release.py script based on the Lemonade project, with utilities for updating GitHub references and documentation, streamlining the open-source release process.

v0.8.3

What's Changed

Installation

Download and run the GAIA installer (gaia-windows-setup.exe)

v0.8.1

What's Changed

Installation

Download and run the GAIA installer (gaia-windows-setup.exe)

v0.7.4

GAIA v0.7.4 Release Notes

New Features

• Voice Interaction: Added comprehensive Talk Mode with ASR and TTS capabilities
• DeepSeek Models Support: Added support for DeepSeek R1 models (1.5B, 7B, 8B, 14B, 32B) via Ollama
• Kokoro TTS: Integrated new text-to-speech engine
• CLI Enhancements:
  • ASR integration for voice commands
  • Transcript download functionality
  • Improved server management and stats
  • Background launch options

Improvements

• Error Handling: Enhanced logging with color-coded messages
• Process Management: Improved process termination using taskkill instead of Stop-Process
• UI Testing: Added better error detection in logs during automated testing
• Installation:
  • Improved installer with dynamic version detection
  • Added NPU driver compatibility checks
  • Enhanced Conda environment management
  • Added local installer build script for testing

Documentation

• Updated Guides:
  • Added comprehensive voice interaction documentation
  • Improved CLI command documentation
  • Added uninstallation instructions to README
  • Updated system requirements and compatibility notes

Other Changes

• Increased test timeout from 10 to 20 minutes for more thorough testing
• Updated copyright notices throughout codebase to 2024-2025
• Updated minimum NPU driver version to 32.0.203.240
• Reorganized package dependencies with new "talk" optional group

Full Changelog: v0.6.3.2...v0.7.4