uv-present-but-not-uv-managed installs still get a raw uv tool upgrade error

Open Beginner friendly

#716 opened on Sep 1, 2026 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty: 2/5
Estimated time: 1-3 hours
Newbie friendliness: 82/100

Issue type: Bug
Clarity: Clearly specified
Activity status: Active
Tech stack: python
Domain: cli

Research direction

Start in src/browser_harness/admin.py at run_update(), especially the pypi branch around line 1231, and review the related missing-uv behavior from #688. Reproduce the non-zero result from uv tool upgrade browser-harness; done means pip/pipx/package-manager guidance is printed before the exit code is propagated.

Written by the indexing model from the issue text.

Description

Problem

A pip/pipx-installed browser-harness on a machine where uv happens to be on PATH still gets uv's raw "not installed via uv" error from uv tool upgrade, with no actionable guidance. This affects the same population the #688 fix (missing-uv case) addresses: users who installed with pip/pipx but have uv present.

Suggested fix

In the pypi branch of run_update() (src/browser_harness/admin.py:1231), when uv tool upgrade browser-harness returns non-zero, print the same actionable stderr message (pip/pipx/package-manager routes) before propagating the exit code.

Source

Branch: fix/688-update-uv-missing
Head: d3e2acc

Metadata

Severity: P3
Confidence: 75
Reviewer(s): adversarial
Finding ID: src/browser_harness/admin.py + line_bucket(1231) + normalize(title)

Dominant language: Python
Stars: 17.8k
Forks: 1.7k
Avg merge: 1d 11h
Merged PRs (30d): 34

Contributor guide

Open the contributing guide

First steps

Read the whole issue, then the project's contributing guide.
Comment on the issue to say you are picking it up — it saves two people doing the same work.
Fork the repository and make your change on a branch.
Open a pull request that references the issue number.

Similar issues

[BUG] GkeTpuCluster queries metadata.google.internal for MEGASCALE_SLICE_ID even when TPU_SKIP_MDS_QUERY is set Open

Difficulty 2/5 1-3 hours Newbie friendliness 88/100

jax-ml/jax#40854 · Opened Sep 22, 2026
[pcied] Honour PCIE_DETACH_INFO on platforms that are not smartswitches Open

Difficulty 2/5 1-3 hours Newbie friendliness 82/100

sonic-net/sonic-platform-daemons#900 · Opened Sep 21, 2026
MCP client has no httpx timeout, so the event stream fails after 5 seconds Open

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

Azure/azure-functions-agents-runtime#228 · Opened Sep 21, 2026
feat(mcp): friendlier error when `run_cloud_sync` is called on a disabled connection Open

enhancement

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

airbytehq/PyAirbyte#1205 · Opened Sep 21, 2026
pn7160: reader goes permanently deaf — post-read IRQ-low check fails reads that succeeded Open

Difficulty 2/5 1-3 hours Newbie friendliness 74/100

esphome/esphome#19452 · Opened Sep 21, 2026

More Python issues