Skip to main content

Cadence Python Client Releases

The Cadence Python client is published on PyPI as cadence-python-client and follows semantic versioning. See the Python client's GitHub Releases for changes between versions.

Latest release

v0.4.1 published on 2026-09-30

0.x release line

The Python client has not reached 1.0. Semantic versioning treats 0.x as initial development, where any release can include breaking changes, so read the release notes before you upgrade.

Python Compatibility

Python versions 3.11, 3.12 and 3.13 are supported at this time.

Major Releases​

v0.4.x​

v0.3.x​

v0.2.x​

v0.1.x​

Recent release notes​

Release v0.4.1 published by shijiesheng on 2026-09-30​

What's Changed

New Contributors

Full Changelog: https://github.com/cadence-workflow/cadence-python-client/compare/v0.4.0...v0.4.1


Release v0.4.0 published by shijiesheng on 2026-09-15​

What's Changed

New Contributors

Full Changelog: https://github.com/cadence-workflow/cadence-python-client/compare/v0.3.0...v0.4.0


Release v0.3.0 published by abhishekj720 on 2026-06-15​

New Features

  • Schedule SDK: Full cadence schedule python SDK support
  • Child workflows: execute_child_workflow, start_child_workflow, ChildWorkflowFuture, full child workflow lifecycle support
  • Signal external workflows: signal_external_workflow API and SignalExternalWorkflowStateMachine
  • Memo support: memo fields on workflow and child workflow starts

Bug Fixes

  • Schedule describe_schedule no longer errors during scheduler ContinueAsNew transition
  • IDL updated to latest version
  • Correct dynamic config path in docker-compose integration test stack

What's Changed

Full Changelog: v0.2.3...v0.3.0


Release v0.2.3 published by shijiesheng on 2026-05-20​

New Features

  • Schedules API: You can now create/describe/change/terminate/backfill schedules. This is still an experimental feature and requires server version >= v1.4.1-prerelease16
  • Workflow Cancel API: allows user to cancel a workflow from the client.
  • Workflow Query: allows users to register and query a workflow state.

What's Changed

New Contributors

Full Changelog: https://github.com/cadence-workflow/cadence-python-client/compare/v0.2.2...v0.2.3


Release v0.2.2 published by timl3136 on 2026-05-04​

What's Changed

This release adds several workflow and activity execution features, improves cross-cluster support, and updates the client's generated Cadence IDL bindings.

New Features

  • Workflow ID reuse policy support
    Added support for configuring workflow ID reuse behavior when starting workflows. This allows callers to control how Cadence handles new workflow executions that reuse an existing workflow ID.

  • Activity retry policy support
    Added RetryPolicy definitions, proto type mapping, and integration with activity options, enabling activities to be configured with retry behavior directly from the Python client.

  • Workflow retry support
    Added retry policy support for workflow executions, allowing workflows to be automatically retried according to configured retry settings.

  • Workflow signal handling
    Added support for handling workflow signals, enabling workflows to receive and react to external signals during execution.

  • Active-active support
    Added client-side support for active-active Cadence deployments.

Improvements

  • Updated Cadence IDL bindings
    Updated cadence-idl to match the current Cadence server HEAD, keeping generated API types aligned with the server.

  • Activity retry integration tests
    Added integration test coverage for activity retry behavior.

  • Build fixes
    Fixed Makefile dependency handling to ensure required dependencies are installed correctly.

Pull Requests

  • Implement workflow ID reuse policy support by @timl3136 — #89
  • Fix Makefile dependency handling by @timl3136 — #90
  • Add activity retry policy support by @timl3136 — #88
  • Add activity retry integration tests by @timl3136 — #91
  • Add workflow retry support by @timl3136 — #92
  • Implement workflow signal handling by @timl3136 — #84
  • Update cadence-idl to match server HEAD by @timl3136 — #97
  • Add active-active support by @timl3136 — #95

Full Changelog: https://github.com/cadence-workflow/cadence-python-client/compare/v0.2.1...v0.2.2


Release v0.2.1 published by shijiesheng on 2026-04-14​

What's Changed

Full Changelog: https://github.com/cadence-workflow/cadence-python-client/compare/v0.2.0...v0.2.1


Release v0.2.0 published by timl3136 on 2026-03-07​

What's Changed

New Contributors

Full Changelog: https://github.com/cadence-workflow/cadence-python-client/compare/v0.1.1...v0.2.0


Release v0.1.0 published by timl3136 on 2026-01-13​

cadence-python-client v0.1.0

This is the initial release of the Cadence Python Client.
It provides the core functionality required to build and run Cadence workflows and activities in Python.

Features

  • Workflow and activity registration via definitions
  • Deterministic workflow execution
  • Workflow completion, failure, and signaling support
  • Activity scheduling from workflows
  • Client APIs for starting and signaling workflows
  • gRPC-based Cadence service client with retries and error mapping
  • Default DataConverter aligned with the Cadence Go client

Build, Test, and Tooling

  • Python project setup using pyproject.toml
  • Protobuf and gRPC code generation
  • Linting, formatting, and type-safety checks
  • Unit and integration tests

Note: This release is a v0.1.0 and the API is not yet stable. Breaking changes may occur in future releases.

Full Changelog:
https://github.com/cadence-workflow/cadence-python-client/commits/v0.1.0


For a comprehensive list of changes and detailed release notes, please visit the Cadence Python Client GitHub Releases page.