Skip to content

Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)

Python

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

Alishahryar1dc089df3171b
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 8647249a..9c1f4ebc 100644
--- a/.github/workflows/tests.yml
+++ b/.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
diff --git a/AGENTS.md b/AGENTS.md
index 73886a07..3710c102 100644
--- a/AGENTS.md
+++ b/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.
diff --git a/README.md b/README.md
index 2107cc48..3e7dbb35 100644
--- a/README.md
+++ b/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
diff --git a/pyproject.toml b/pyproject.toml
index ab6307e4..3a4ea0a4 100644
--- a/pyproject.toml
+++ b/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" }
diff --git a/uv.lock b/uv.lock
index 980a3b38..53aa8abd 100644
--- a/uv.lock
+++ b/uv.lock
@@ -1,6 +1,6 @@
version = 1
revision = 3
-requires-python = ">=3.14"
+requires-python = ">=3.14.0"
[[package]]
name = "accelerate"