1. Check Prerequisites
   ├── PowerShell version >= 5.1
   ├── Python 3.10+ installed (py --version)
   └── Internet connectivity

2. Install uv (if not present)
   └── irm https://astral.sh/uv/install.ps1 | iex

3. Create GAIA Environment
   ├── Create directory: $env:USERPROFILE\.gaia
   ├── Create venv: uv venv $env:USERPROFILE\.gaia\venv
   └── Activate venv

4. Install GAIA Package
   └── uv pip install amd-gaia

5. Add to PATH
   ├── Add $env:USERPROFILE\.gaia\venv\Scripts to PATH
   └── Update registry (User environment)

6. Print Next Steps
   └── "Run: gaia init"

# scripts/install.ps1
$ErrorActionPreference = "Stop"
$GAIA_HOME = "$env:USERPROFILE\.gaia"
$GAIA_VENV = "$GAIA_HOME\venv"
$MIN_PYTHON_VERSION = [version]"3.10"

function Test-PythonVersion  # Check Python >= 3.10
function Install-Uv          # Install uv if missing
function Install-Gaia        # Install GAIA package
function Add-ToPath          # Update PATH registry
function Main                # Orchestrate installation

Main

1. Detect Environment
   ├── OS: Linux (reject macOS if needed)
   ├── Architecture: x86_64 (amd64)
   └── Shell: bash/zsh

2. Check Prerequisites
   ├── Python 3.10+ (python3 --version)
   ├── curl or wget available
   └── Internet connectivity

3. Install uv (if not present)
   └── curl -LsSf https://astral.sh/uv/install.sh | sh

4. Create GAIA Environment
   ├── mkdir -p ~/.gaia
   ├── uv venv ~/.gaia/venv
   └── source ~/.gaia/venv/bin/activate

5. Install GAIA Package
   └── uv pip install amd-gaia

6. Add to PATH
   ├── Add ~/.gaia/venv/bin to ~/.bashrc
   ├── Add to ~/.zshrc if exists
   └── Export for current session

7. Print Next Steps
   └── "Run: source ~/.bashrc && gaia init"

#!/bin/bash
set -euo pipefail

GAIA_HOME="$HOME/.gaia"
GAIA_VENV="$GAIA_HOME/venv"
MIN_PYTHON_MAJOR=3
MIN_PYTHON_MINOR=10

check_python   # Check Python >= 3.10
install_uv     # Install uv if missing
create_venv    # Create virtual environment
install_gaia   # Install GAIA package
add_to_path    # Update shell rc files
main           # Orchestrate installation

main "$@"

gaia init [--profile PROFILE] [--skip-models] [--force-reinstall] [--force-models] [--yes]

gaia update [OPTIONS]

$ gaia update --check

Checking for updates...

Package          Installed    Latest    Status
-----------------------------------------------------
GAIA             1.2.0        1.3.0     Update available
Lemonade Server  9.1.4        9.1.4     Up to date

Run 'gaia update' to install updates.

gaia update Flow
================

1. Check Current Versions
   ├── GAIA: from gaia.version
   └── Lemonade: from lemonade-server --version

2. Fetch Latest Versions
   ├── GAIA: PyPI API
   └── Lemonade: GitHub Releases API

3. Compare & Display
   ├── Show version table
   └── Indicate what needs update

4. Update (if requested)
   ├── GAIA: uv pip install --upgrade amd-gaia
   └── Lemonade: Use existing LemonadeInstaller

5. Verify
   └── Check versions after update

@dataclass
class VersionInfo:
    package: str
    installed: str | None
    latest: str | None
    update_available: bool

class UpdateCommand:
    def __init__(self, check_only: bool, gaia_only: bool):
        self.version_checker = VersionChecker()

    def run(self) -> int:
        versions = self._check_versions()
        self._display_versions(versions)

        if self.check_only:
            return 0

        return self._perform_update(versions)

# manifests/a/AMD/GAIA/1.0.0/AMD.GAIA.yaml
PackageIdentifier: AMD.GAIA
PackageVersion: 1.0.0
PackageLocale: en-US
Publisher: Advanced Micro Devices, Inc.
PublisherUrl: https://www.amd.com
PublisherSupportUrl: https://github.com/amd/gaia/issues
PackageName: GAIA
License: MIT
LicenseUrl: https://github.com/amd/gaia/blob/main/LICENSE.md
ShortDescription: AMD's open-source framework for running generative AI applications locally
Description: |
  GAIA enables developers to build and run AI agents locally on AMD hardware
  with NPU optimization. Features include chat, code generation, voice interaction,
  RAG, and integration with Lemonade Server.
Homepage: https://amd-gaia.ai
Tags:
  - ai
  - llm
  - amd
  - python
  - cli
  - machine-learning
Installers:
  - Architecture: x64
    InstallerType: exe
    InstallerUrl: https://github.com/amd/gaia/releases/download/v1.0.0/gaia-setup.exe
    InstallerSha256: COMPUTED_AT_RELEASE
    InstallerSwitches:
      Silent: /S
      SilentWithProgress: /S
ReleaseDate: 2026-01-23
ManifestType: singleton
ManifestVersion: 1.6.0

gaia_1.0.0-1_amd64.deb
├── DEBIAN/
│   ├── control         # Package metadata
│   ├── postinst       # Post-install script (PATH setup)
│   └── prerm          # Pre-removal script (cleanup)
├── usr/
│   └── local/
│       └── gaia/
│           ├── bin/
│           │   └── gaia      # Wrapper script
│           └── venv/         # Bundled virtualenv
└── etc/
    └── profile.d/
        └── gaia.sh           # PATH setup

$ gaia doctor

GAIA System Diagnostics
========================================
  ✓ Python version: 3.11.0
  ✓ GAIA installation: 0.16.0
  ✓ Lemonade server: Running
  ✓ Default model: Loaded
  ✓ Disk space: 45 GB available

All checks passed!

gaia uninstall          # Remove GAIA (keep data)
gaia uninstall --purge  # Remove everything including models