Skip to content

Expand installer plan with technical details#267

Merged
kovtcharov merged 2 commits into
mainfrom
kalin/installer
Jan 27, 2026
Merged

Expand installer plan with technical details#267
kovtcharov merged 2 commits into
mainfrom
kalin/installer

Conversation

@kovtcharov
Copy link
Copy Markdown
Collaborator

Comprehensive update to the GAIA Installer & Update Plan with detailed technical specifications for Windows and Linux distribution.

Changes

  • Technical Decisions: Added decision log documenting key choices (uv as package manager, no Python bundling, winget as primary Windows distribution)
  • Install Scripts: Detailed technical flows and script structures for install.ps1 and install.sh
  • Distribution Channels: Added comparison matrix of 9 distribution methods with pros/cons
  • winget Package: Complete manifest example and submission requirements
  • Debian Package: Directory structure for .deb packaging
  • Update Command: Architecture diagram, version checking sources, code structure
  • Implementation Phases: Reorganized with dependencies and deliverables
  • Open Questions: 5 items requiring resolution before implementation

Key Decisions

Decision Choice
Windows primary winget + PowerShell script
Linux primary Bash script + .deb
Package manager uv (install if missing)
Python bundling No - require 3.10+ pre-installed
Install location ~/.gaia/venv/ (user-space)

@kovtcharov kovtcharov added this to the v0.15.3 milestone Jan 26, 2026
@kovtcharov kovtcharov requested a review from itomek-amd January 26, 2026 23:51
@kovtcharov kovtcharov self-assigned this Jan 26, 2026
@kovtcharov kovtcharov added documentation Documentation changes roadmap labels Jan 26, 2026
- Replace curly brace patterns in code blocks with comments
- Change <computed-at-release> to COMPUTED_AT_RELEASE
- Replace < symbols with "Under" in metrics table
- Simplify version endpoint descriptions
@kovtcharov kovtcharov enabled auto-merge January 27, 2026 00:20
@kovtcharov kovtcharov added this pull request to the merge queue Jan 27, 2026
Merged via the queue into main with commit 0828a79 Jan 27, 2026
60 checks passed
@kovtcharov kovtcharov deleted the kalin/installer branch January 27, 2026 00:51
@kovtcharov kovtcharov restored the kalin/installer branch January 27, 2026 05:18
@kovtcharov kovtcharov deleted the kalin/installer branch January 27, 2026 05:30
itomek pushed a commit that referenced this pull request Mar 12, 2026
Comprehensive update to the GAIA Installer & Update Plan with detailed
technical specifications for Windows and Linux distribution.

### Changes

- **Technical Decisions**: Added decision log documenting key choices
(uv as package manager, no Python bundling, winget as primary Windows
distribution)
- **Install Scripts**: Detailed technical flows and script structures
for `install.ps1` and `install.sh`
- **Distribution Channels**: Added comparison matrix of 9 distribution
methods with pros/cons
- **winget Package**: Complete manifest example and submission
requirements
- **Debian Package**: Directory structure for `.deb` packaging
- **Update Command**: Architecture diagram, version checking sources,
code structure
- **Implementation Phases**: Reorganized with dependencies and
deliverables
- **Open Questions**: 5 items requiring resolution before implementation

### Key Decisions

| Decision | Choice |
|----------|--------|
| Windows primary | winget + PowerShell script |
| Linux primary | Bash script + .deb |
| Package manager | uv (install if missing) |
| Python bundling | No - require 3.10+ pre-installed |
| Install location | `~/.gaia/venv/` (user-space) |
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Documentation changes roadmap

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants