From 95af394c20d641e52cf60b655b9218a2275bac4c Mon Sep 17 00:00:00 2001 From: Kushagra Kanaujia Date: Fri, 20 Nov 2026 12:56:55 -0800 Subject: [PATCH] README and install docs: Python 3.11+ and a uvx one-liner On a Mac's built-in Python 3.9, pip install throttle-pro fails with 'No matching distribution found', which reads like the package is missing. Say what the error means and give the uvx command, which fetches a recent Python itself (verified from a clean home with uv-managed Python only). Co-Authored-By: Claude Opus 5.5 --- README.md | 11 ++++++++++- .../console/docs/getting-started/installation.md | 6 ++++++ 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 6d1cedf..50b502f 100644 --- a/README.md +++ b/README.md @@ -37,7 +37,16 @@ throttle scan . throttle demo ``` -Pin the version so what you install never changes under you. +Pin the version so what you install never changes under you. Throttle needs +**Python 3.11 or newer**. On a Mac, the built-in `python3` is 3.9, and pip +then says `No matching distribution found for throttle-pro`. That means your +Python is too old, not that the package is missing. With +[uv](https://docs.astral.sh/uv/) you can skip installing anything; it fetches +a recent Python on its own: + +```sh +uvx --from "throttle-pro==0.8.0" throttle scan . +``` `throttle scan .` reads the code in the current folder and lists the OpenAI and Anthropic SDK calls it can read: where each diff --git a/src/throttle/console/docs/getting-started/installation.md b/src/throttle/console/docs/getting-started/installation.md index 172976f..f86863f 100644 --- a/src/throttle/console/docs/getting-started/installation.md +++ b/src/throttle/console/docs/getting-started/installation.md @@ -16,6 +16,12 @@ pipx install "throttle-pro==0.8.0" throttle --version ``` +```bash uv +uvx --from "throttle-pro==0.8.0" throttle scan . +``` + +On a Mac the built-in `python3` is 3.9. There pip says `No matching distribution found for throttle-pro`: your Python is too old, the package is there. `uvx` (from [uv](https://docs.astral.sh/uv/)) fetches a recent Python by itself, so it works without installing one. + That gives you the whole loop (`capture`, `workloads`, `shadow`, `eval`, `report`, `route`, `refresh`, `demo`), `jobs`, `pr-check` and the serving tools such as `check`. To install straight from the source you can read, use the release tag: