uvx and uv run not equivalent? uvx fails resolving tool dependencies

[maphew]

On windows in CMD prompt or Powershell with "uv 0.5.20 (1c17662 2025-01-15)" I get the below:

foobar.py:

# /// script
# requires-python = ">=3.12"
# dependencies = [
#     "click",
#     "rich",
# ]
# ///
print('Hello')

Fails:

D:\x
λ uvx foobar.py
  x No solution found when resolving tool dependencies:
  `-> Because foobar-py was not found in the package registry and you require foobar-py, we can conclude that your requirements are unsatisfiable.

Works:

D:\x
λ uv run foobar.py
Hello

[zanieb]

Please remember to consult the documentation before opening issues, as described in #9452.

• https://docs.astral.sh/uv/guides/tools/#running-tools
• https://docs.astral.sh/uv/concepts/tools/#relationship-to-uv-run
• https://docs.astral.sh/uv/reference/cli/#uv-tool-run
• https://docs.astral.sh/uv/reference/cli/#uv-run

[maphew]

Thanks zanieb. I was keying off another Astral page that said the uvx was an identical alias to uv run. I'll re-open if/when I find the page with the wrong info.

[maphew]

...it must not have been an Astral page. Somehow I completely missed the concept of tool, and it's quite clear that's a fundamental idea that's been around for awhile. Apologies for the noise!

A small mark in my defense, the error message doesn't give much to go on. For example the OP script does not "require foo-py" and I do not see anything in the pages referenced above that talks about that (admittedly, I skimmed).

[zanieb]

We can add a hint to the error here #10784