Add one-command installer scripts for Windows and Linux#305
Merged
kovtcharov-amd merged 5 commits intomainfrom Feb 10, 2026
Merged
Add one-command installer scripts for Windows and Linux#305kovtcharov-amd merged 5 commits intomainfrom
kovtcharov-amd merged 5 commits intomainfrom
Conversation
Implements Phase 1 of the installer plan (docs/plans/installer.mdx): - Windows PowerShell installer (install.ps1) - Linux bash installer (install.sh) Key features: - Zero-dependency: Only requires uv (auto-installs Python 3.12 if needed) - Follows quickstart.mdx pattern (uv venv --python 3.12) - Creates ~/.gaia/venv virtual environment - Installs amd-gaia package - Automatically adds to PATH - Linux uses CPU-only PyTorch (--extra-index-url) - UTF-8 with BOM encoding for PowerShell compatibility - Colored output with Unicode check marks (✓/✗) Usage: Windows: irm https://amd-gaia.ai/install.ps1 | iex Linux: curl -fsSL https://amd-gaia.ai/install.sh | sh Tested on Windows 11 with Python 3.12.12 (auto-installed by uv) Co-Authored-By: Claude Sonnet 4.5 (1M context) <[email protected]>
Changes: - Add "Quick Install" section at the top with one-command installers - Clarify use cases: * Quick Install: Recommended for users trying GAIA CLI * Manual Install (PyPI): Recommended for developers integrating GAIA * Clone: For contributors - Update tab titles: "Windows (PyPI)", "Linux (PyPI)", "Windows (Clone)", "Linux (Clone)" - Use amd-gaia.ai URLs (Cloudflare redirects configured) Makes it clear which installation method to use: - Users → Quick Install (one command) - Developers → Manual Install (project-specific venv) - Contributors → Clone (editable install) Co-Authored-By: Claude Sonnet 4.5 (1M context) <[email protected]>
Critical fixes:
- Fix path references to be platform-specific (Windows: %USERPROFILE%, Linux: ~)
- Change "globally" to "accessible globally via PATH" (more accurate)
- Update setup.mdx to mention Quick Install option
- Add idempotency checks to both installers (safe to re-run)
- Clarify CPU-only PyTorch mention for Linux
Changes:
1. docs/quickstart.mdx:
- Windows shows %USERPROFILE%\.gaia\venv
- Linux shows ~/.gaia/venv
- Clarify PyTorch mention ("CPU-only PyTorch (smaller, faster)")
2. docs/setup.mdx:
- Add Info box linking to Quick Install
- Clarifies manual install is for development
3. scripts/install.ps1:
- Check if gaia.exe exists before installing
- Show helpful message if already installed
4. scripts/install.sh:
- Check if gaia binary exists before installing
- Show helpful message if already installed
Co-Authored-By: Claude Sonnet 4.5 (1M context) <[email protected]>
Co-Authored-By: Claude Sonnet 4.5 (1M context) <[email protected]>
Changes installer behavior to be truly idempotent: - First run: Install GAIA - Subsequent runs: Check for updates and auto-upgrade if available - If up to date: Show "already up to date" message Benefits: - Users can re-run installer to get latest version - No need to manually uninstall/reinstall - Safer than deleting ~/.gaia directory - Matches behavior of other modern installers (rustup, uv, etc.) Implementation: - Windows: Use python.exe from venv to run pip upgrade - Linux: Use uv pip with --extra-index-url for CPU-only PyTorch - Both: Run quietly, show success/already-up-to-date message Co-Authored-By: Claude Sonnet 4.5 (1M context) <[email protected]>
kovtcharov-amd
approved these changes
Feb 9, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Implements Phase 1 of the installer plan: one-command installation scripts for Windows and Linux.
What's Included
Windows PowerShell Installer (
scripts/install.ps1)uvif not present~/.gaia/venvwith Python 3.12 (uv downloads if needed)amd-gaiapackageLinux Bash Installer (
scripts/install.sh)uvif not present~/.gaia/venvwith Python 3.12 (uv downloads if needed)amd-gaiawith CPU-only PyTorch (--extra-index-url)Usage
Windows:
Linux:
curl -fsSL https://amd-gaia.ai/install.sh | shZero Dependencies
Following the pattern from
docs/quickstart.mdx, the installers:uv venv --python 3.12to auto-download PythonHosting
Scripts can be hosted via:
https://raw.githubusercontent.com/amd/gaia/main/scripts/install.ps1amd-gaia.ai/install.ps1→ GitHub raw URLTesting
✅ Tested on Windows 11 with PowerShell
Related
docs/plans/installer.mdxgaia updatecommand (Phase 2)Checklist