# NousResearch/hermes-agent · Windows installer mishandles uv shims from package managers

## Open now

- Nothing open on GitHub.

These issues and PRs address a bug where the Windows installer incorrectly accepts or copies uv shims from package managers like Chocolatey, and propose fixes to detect and reject such shims while also self-healing the managed uv installation on rerun.

## TL;DR

- 7 member(s): 0 open issue(s), 1 closed issue(s), 0 open PR(s), 1 merged PR(s), 5 PR(s) closed without merging.
- A fix was merged to main in PR #115679. Verify it addresses your case.
- **Recommended:** read PR #115679 (and any competing PRs below) before filing. Confirm the merged change covers your symptom.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `resolved` · deciding PR(s): `pr-115679`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_SPANNING`): every member is connected by structural evidence: shared changed files, or a closing/superseded reference.
- Pairwise link density `0.29`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Closed / duplicate issues

- #110350: \[Bug\]: Windows installer copies Chocolatey uv shim and fails Python 3.11 verification

## Prior & competing PRs

- **#115679: fix(install): Windows installer rejects relocated uv shims and self-heals the managed uv (#110350, salvage #110355)**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`; implication `superseded`
  - files: `.github/workflows/installer-tests.yml`, `hermes_cli/managed_uv.py`, `scripts/install.ps1`, `scripts/tests/test-install-ps1-uv-shim-validation.ps1`, `tests/hermes_cli/test_managed_uv.py`
- **#110355: fix(install): reject broken copied uv shims**. closed without merge
  - maintainer direction: category `merged_via`; implication `superseded`; refs `4d59f894ee`, `#115679`, `#115679`
- **#110375: fix(installer): reject unusable Chocolatey uv shims**. closed without merge
  - maintainer direction: category `duplicate_of`; implication `duplicate`; refs `#110355`, `#110378`
- **#110378: fix(installer): resolve package manager shim targets and self-heal managed uv on rerun**. closed without merge
  - maintainer direction: category `duplicate_of`; implication `duplicate`; refs `#110355`, `#110350`, `#110355`
- **#110421: fix(installer): resolve package manager shim targets and self-heal managed uv on rerun**. closed without merge
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `4d59f894ee`, `#115679`, `#115679`
- **#114634: fix(install.ps1): reject broken/relocated package-manager uv shims; self-heal managed uv (#110350)**. closed without merge
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `4d59f894ee`, `#115679`, `#115679`

## Fix status

- Merged to main in PR #115679 (cited above). No release data is tracked. Verify downstream.
- Fix last verified (merged) `2026-09-19`.
