Skip to content

stagehand-python@4.4.0a0.dev1664

stagehand-python@4.4.0a0.dev1664: [chore]: migrate to uv workspace (#3338)
@seanmcguire12 seanmcguire12 tagged this 03 Nov 01:11 
# why
- to make managing dependencies across the monorepo easier
# what changed
- moved all python projects into a root uv workspace with a single
uv.lock & .venv
- cookbooks & integrations now use the local sdk & middleware during
development
- removed all project specific lockfiles
- `just` cmds, ci/release tooling now use root workspace
- also updates docs & contributor instructions

<!-- This is an auto-generated description by cubic. -->
---
## Summary by cubic
Migrates all Python projects to a root uv workspace with a single shared
`uv.lock` and `.venv`, making dependency management across the monorepo
consistent.

- The SDK, core middleware, Deepagents integration, examples, and Python
cookbooks now resolve as workspace members; per-project lockfiles were
removed.
- Cookbooks and Deepagents examples use the local SDK and middleware
source during development instead of published packages.
- `just` commands, CI path filters, and release tooling now run against
the root workspace.
- Preview and alpha builds pin the development SDK version across
workspace consumers so they resolve in disposable checkouts.
- The bundled Deepagents runner targets the root workspace explicitly;
custom runners keep their own project environment.
- Python cookbooks move from the pinned `stagehand==4.1.0` dependency to
the workspace SDK (`>=4.3.0,<5`), and Deepagents projects drop the
`<3.14` Python cap and the managed example's websockets override.

**Migration**

- Run `just install` from the repository root; it uses `pnpm install
--frozen-lockfile` and `uv sync --all-packages --locked`, replacing
single-project `uv sync --locked` calls.

<sup>Written for commit 164e2861572ed819c93966029e5aa530d9aaaa19.
Summary will update on new commits.</sup>

<a
href="https://cubic.dev/pr/browserbase/stagehand/pull/3338?utm_source=github"
target="_blank" rel="noopener noreferrer"
data-no-image-dialog="true"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"><source
media="(prefers-color-scheme: light)"
srcset="https://www.cubic.dev/buttons/review-in-cubic-light.svg"><img
alt="View guided diff"
src="https://www.cubic.dev/buttons/review-in-cubic-light.svg"></picture></a>
<a
href="https://www.cubic.dev/action/auto-fix/pr/browserbase/stagehand/3338?returnTo=https%3A%2F%2Fgithub.com%2Fbrowserbase%2Fstagehand%2Fpull%2F3338&source=description"
target="_blank" rel="noopener noreferrer"
data-no-image-dialog="true"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://www.cubic.dev/buttons/turn-on-auto-fix-dark.svg"><source
media="(prefers-color-scheme: light)"
srcset="https://www.cubic.dev/buttons/turn-on-auto-fix-light.svg"><img
alt="Turn on auto-fix"
src="https://www.cubic.dev/buttons/turn-on-auto-fix-light.svg"></picture></a>

<!-- End of auto-generated description by cubic. -->
Assets 2
Loading