Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
| 1 | # Python Release Workflow |
| 2 | |
| 3 | ## Build |
| 4 | |
| 5 | Run from `python/` after the environment is ready: |
| 6 | |
| 7 | ```bash |
| 8 | make build |
| 9 | ``` |
| 10 | |
| 11 | `make build` cleans build outputs, builds the root package, then builds provider packages and collects distributions. |
| 12 | |
| 13 | Stable and beta Python releases use the unified `sdk.release.yml` member request and one approved release PR; a beta publishes `X.Y.ZbN` for core and every provider. Author changesets for the private `@composio/python-sdk` marker; the release bot synchronizes core and all supported provider metadata. Read `ts/docs/internal/release.md` for request, approval, merge, recovery and owner setup steps. |
| 14 | |
| 15 | Recovery: re-run a failed tag run with `gh run rerun <tag-run-id> --failed`. When the approved candidate expired, add a changeset and request a new release. Agents stop at "release PR ready for approval" and never merge it. |
| 16 | |
| 17 | Candidate builds install only the `release` dependency group from `uv.lock` with `uv sync --locked --only-group release` and use `BUILD_ARGS=--no-isolation`. Bump `build` or `setuptools` in that group, then run `uv lock`. Stable publication uses the tag-only `pypi-release` OIDC environment. The legacy `py.release.yml` keeps build-only dispatch and core-prerelease publication through `pypi`. |
| 18 | |
| 19 | ## Dependency Bounds |
| 20 | |
| 21 | Third-party runtime dependencies carry an upper bound at the next major line after the newest release available when the cap was set (`<1` for 0.x packages). `certifi` stays uncapped so CA bundle updates always install. `pysher` is pinned exactly because it is unmaintained. Keep `pyproject.toml` and `setup.py` identical for each package. |
| 22 | |
| 23 | ## Client Pin Bumps |
| 24 | |
| 25 | Before bumping `composio-client`, verify the version resolves: |
| 26 | |
| 27 | ```bash |
| 28 | pip index versions composio-client |
| 29 | ``` |
| 30 | |
| 31 | Update all Python pins together: |
| 32 | |
| 33 | - `python/pyproject.toml` |
| 34 | - `python/setup.py` |
| 35 | - root `uv.lock` |
| 36 | |
| 37 | Regenerate the lockfile from the repo root: |
| 38 | |
| 39 | ```bash |
| 40 | uv lock --upgrade-package composio-client |
| 41 | ``` |
| 42 | |
| 43 | ## Verification |
| 44 | |
| 45 | Run import and package checks after dependency changes: |
| 46 | |
| 47 | ```bash |
| 48 | uv run --package composio python -c "import composio" |
| 49 | ``` |
| 50 | |
| 51 | Then run the focused nox/Makefile checks relevant to the change. |