Migrate from rye to uv for dependency management

Rye is deprecated in favor of uv (its successor from the same maintainers).
Replace all rye usage with uv equivalents:

- pyproject.toml: [tool.rye] → [tool.uv], merge dev-dependencies into
  [dependency-groups] dev, remove [tool.rye.scripts]
- Shell scripts: rye run → uv run with inlined commands
- CI workflows: rye install → astral-sh/setup-uv@v5 action
- Dev container: install uv instead of rye
- Brewfile: brew "uv"
- Delete requirements.lock and requirements-dev.lock (replaced by uv.lock)
- Update all docs, AI assistant configs, and cursor rules

Author: x

.claude/settings.json

@@ -3,13 +3,13 @@
     "allow": [
       "WebSearch",
       "WebFetch(domain:docs.temporal.io)",
-      "Bash(rye run pytest:*)",      
-      "Bash(rye run lint:*)",
-      "Bash(rye run typecheck:*)",
-      "Bash(rye run sync:*)",
-      "Bash(rye run build:*)"
+      "Bash(uv run pytest:*)",
+      "Bash(uv run ruff:*)",
+      "Bash(uv run pyright:*)",
+      "Bash(uv sync:*)",
+      "Bash(uv build:*)"
     ],
     "deny": [],
     "ask": []
   }
-}
+}

.cursor/rules/00_repo_tooling.mdc

@@ -4,15 +4,15 @@ globs: "**/*"
 alwaysApply: true
 ---
 
-Use Rye for Python dependency management and workflows. Prefer these commands:
+Use uv for Python dependency management and workflows. Prefer these commands:
 
-- Setup env: `./scripts/bootstrap` or `rye sync --all-features` [[Use Rye in this repo]]
-- Run tests: `rye run pytest` or `./scripts/test`
-- Run a specific test: `rye run pytest path/to/test_file.py::TestClass::test_method -v`
-- Format: `rye run format` or `./scripts/format`
-- Lint: `rye run lint` or `./scripts/lint`
-- Type check: `rye run typecheck` (runs pyright and mypy)
-- Build: `rye build`
+- Setup env: `./scripts/bootstrap` or `uv sync --all-groups`
+- Run tests: `uv run pytest` or `./scripts/test`
+- Run a specific test: `uv run pytest path/to/test_file.py::TestClass::test_method -v`
+- Format: `uv run ruff format` or `./scripts/format`
+- Lint: `uv run ruff check .` or `./scripts/lint`
+- Type check: `uv run pyright`
+- Build: `uv build`
 
 Environment requirements:
 
@@ -21,4 +21,4 @@ Environment requirements:
 
 Notes:
 
-- Only use `uv` inside of tutorial folders which have their own virtualenv (managed by a tutorial specific pyproject.toml inside the relevant tutorial folder). Otherwise use rye at the top level.
+- Tutorial folders have their own virtualenv (managed by a tutorial specific pyproject.toml inside the relevant tutorial folder). Use `uv run` within those folders.

.cursor/rules/05_permissions_and_tools.mdc

@@ -8,11 +8,11 @@ When invoking external tools or the terminal, follow these constraints:
 
 - Web search is allowed when needed for docs and references
 - Prefer fetching docs from `docs.temporal.io` when researching Temporal topics
-- Allowed bash commands should go through Rye workflows:
-  - `rye run pytest:*`
-  - `rye run lint:*`
-  - `rye run typecheck:*`
-  - `rye run sync:*`
-  - `rye run build:*`
+- Allowed bash commands should go through uv workflows:
+  - `uv run pytest`
+  - `uv run ruff check .`
+  - `uv run pyright`
+  - `uv sync`
+  - `uv build`
 
-Default to Rye; only use other tools when explicitly required by the codebase.
+Default to uv; only use other tools when explicitly required by the codebase.

.cursor/rules/50_tests_and_mocking.mdc

@@ -6,8 +6,8 @@ alwaysApply: true
 
 Testing:
 
-- Run tests with `rye run pytest` or `./scripts/test`
-- To run a specific test: `rye run pytest path/to/test_file.py::TestClass::test_method -v`
+- Run tests with `uv run pytest` or `./scripts/test`
+- To run a specific test: `uv run pytest path/to/test_file.py::TestClass::test_method -v`
 - A mock server is automatically started for tests on port 4010
 
 When writing tests:

.cursor/rules/60_style_lint_typecheck.mdc

@@ -6,9 +6,9 @@ alwaysApply: true
 
 Standards:
 
-- Format code via `rye run format` or `./scripts/format`
-- Lint via `rye run lint` or `./scripts/lint`
-- Type check via `rye run typecheck` (pyright + mypy)
+- Format code via `uv run ruff format` or `./scripts/format`
+- Lint via `uv run ruff check .` or `./scripts/lint`
+- Type check via `uv run pyright`
 
 Guidance:
 

.devcontainer/Dockerfile

@@ -3,7 +3,6 @@ FROM mcr.microsoft.com/vscode/devcontainers/python:0-${VARIANT}
 
 USER vscode
 
-RUN curl -sSf https://rye.astral.sh/get | RYE_VERSION="0.44.0" RYE_INSTALL_OPTION="--yes" bash
-ENV PATH=/home/vscode/.rye/shims:$PATH
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /usr/local/bin/
 
 RUN echo "[[ -d .venv ]] && source .venv/bin/activate || export PATH=\$PATH" >> /home/vscode/.bashrc

.devcontainer/devcontainer.json

@@ -7,21 +7,18 @@
     "context": ".."
   },
 
-  "postStartCommand": "rye sync --all-features",
+  "postStartCommand": "uv sync --all-groups",
 
   "customizations": {
     "vscode": {
       "extensions": [
         "ms-python.python"
       ],
-      "settings": { 
+      "settings": {
         "terminal.integrated.shell.linux": "/bin/bash",
         "python.pythonPath": ".venv/bin/python",
         "python.defaultInterpreterPath": ".venv/bin/python",
-        "python.typeChecking": "basic",
-        "terminal.integrated.env.linux": {
-          "PATH": "/home/vscode/.rye/shims:${env:PATH}"
-        }
+        "python.typeChecking": "basic"
       }
     }
   },

.github/workflows/ci.yml

@@ -21,16 +21,11 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
-      - name: Install Rye
-        run: |
-          curl -sSf https://rye.astral.sh/get | bash
-          echo "$HOME/.rye/shims" >> $GITHUB_PATH
-        env:
-          RYE_VERSION: '0.44.0'
-          RYE_INSTALL_OPTION: '--yes'
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
 
       - name: Install dependencies
-        run: rye sync --all-features
+        run: uv sync --all-groups
 
       - name: Run lints
         run: ./scripts/lint
@@ -46,19 +41,14 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
-      - name: Install Rye
-        run: |
-          curl -sSf https://rye.astral.sh/get | bash
-          echo "$HOME/.rye/shims" >> $GITHUB_PATH
-        env:
-          RYE_VERSION: '0.44.0'
-          RYE_INSTALL_OPTION: '--yes'
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
 
       - name: Install dependencies
-        run: rye sync --all-features
+        run: uv sync --all-groups
 
       - name: Run build
-        run: rye build
+        run: uv build
 
       - name: Get GitHub OIDC Token
         if: github.repository == 'stainless-sdks/agentex-sdk-python'
@@ -83,13 +73,8 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
-      - name: Install Rye
-        run: |
-          curl -sSf https://rye.astral.sh/get | bash
-          echo "$HOME/.rye/shims" >> $GITHUB_PATH
-        env:
-          RYE_VERSION: '0.44.0'
-          RYE_INSTALL_OPTION: '--yes'
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
 
       - name: Bootstrap
         run: ./scripts/bootstrap

.github/workflows/publish-pypi.yml

@@ -16,13 +16,8 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
-      - name: Install Rye
-        run: |
-          curl -sSf https://rye.astral.sh/get | bash
-          echo "$HOME/.rye/shims" >> $GITHUB_PATH
-        env:
-          RYE_VERSION: "0.44.0"
-          RYE_INSTALL_OPTION: "--yes"
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
 
       - name: Publish to PyPI
         run: |

Brewfile

@@ -1,2 +1 @@
-brew "rye"
-
+brew "uv"