Pin stable Python 3.14.0 and require uv 0.9+ for correct downloads.

Old uv versions resolved 3.14.0 to pre-releases; enforce a minimum uv version
and document reinstall steps so contributors get the final 3.14.0 build.

.github/workflows/tests.yml

@@ -65,7 +65,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b
         with:
-          version: "0.10.4"
+          version: "0.11.15"
           enable-cache: true
           cache-python: true
 

AGENTS.md

@@ -5,7 +5,7 @@
 ## CODING ENVIRONMENT
 
 - Install astral uv using "curl -LsSf https://astral.sh/uv/install.sh | sh" if not already installed and if already installed then update it to the latest version
-- Install Python 3.14 using `uv python install 3.14` if not already installed
+- Install Python 3.14.0 stable using `uv python install 3.14.0` if not already installed (requires uv >=0.9; see `[tool.uv] required-version` in `pyproject.toml`)
 - Always use `uv run` to run files instead of the global `python` command.
 - Current uv ruff formatter is set to py314 which has supports multiple exception types without paranthesis (except TypeError, ValueError:)
 - Read `.env.example` for environment variables.

README.md

@@ -56,14 +56,14 @@ npm install -g @anthropic-ai/claude-code
 
 ### 2. Install Runtime Requirements
 
-Install the latest version of [uv](https://docs.astral.sh/uv/getting-started/installation/) and Python 3.14.
+Install the latest version of [uv](https://docs.astral.sh/uv/getting-started/installation/) (0.9+) and Python 3.14.0 stable.
 
 macOS/Linux:
 
 ```bash
 curl -LsSf https://astral.sh/uv/install.sh | sh
 uv self update
-uv python install 3.14
+uv python install 3.14.0
 ```
 
 Windows PowerShell:
@@ -71,9 +71,11 @@ Windows PowerShell:
 ```powershell
 powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
 uv self update
-uv python install 3.14
+uv python install 3.14.0
 ```
 
+If you previously installed 3.14 with an older uv and see alpha-only behavior (e.g. `except TypeError, ValueError` fails), run `uv self update` then `uv python install 3.14.0 --reinstall` and recreate the venv with `uv sync`.
+
 ### 3. Install The Proxy
 
 ```bash

pyproject.toml

@@ -7,7 +7,7 @@ name = "free-claude-code"
 version = "2.0.0"
 description = "Middleware between Claude Code CLI (Anthropic API) and NVIDIA NIM"
 readme = "README.md"
-requires-python = ">=3.14"
+requires-python = ">=3.14.0"
 dependencies = [
     "fastapi[standard]>=0.136.1",
     "uvicorn>=0.47.0",
@@ -50,6 +50,10 @@ packages = ["api", "cli", "config", "core", "messaging", "providers"]
 ".env.example" = "cli/env.example"
 "api/admin_static" = "api/admin_static"
 
+[tool.uv]
+# uv <0.9 only had 3.14 pre-releases in download metadata; 0.9+ ships stable 3.14.0.
+required-version = ">=0.9.0"
+
 [tool.uv.sources]
 torch = { index = "pytorch-cu130" }
 

uv.lock

@@ -1,6 +1,6 @@
 version = 1
 revision = 3
-requires-python = ">=3.14"
+requires-python = ">=3.14.0"
 
 [[package]]
 name = "accelerate"