Python SDK 1.33.12

Overview

Fixed

• Fixed a bug where _aio_memo crashes on durable task replay when the engine returns memo_already_existed=True with an empty payload (b''). Proto3 unset bytes fields deserialize to b'' rather than None, slipping past the is not None guard and crashing validate_json(b'').

Installation

Install the SDK using pip:

pip install hatchet-sdk

Or using poetry:

poetry add hatchet-sdk

Documentation

For detailed documentation, examples, and best practices, visit:

• Hatchet Documentation
• Examples

What's Changed?

• chore: Bump pyjwt from 2.12.1 to 2.13.0 in /sdks/python (#4198) by @app/dependabot
• chore: Bump python-multipart from 0.0.27 to 0.0.31 in /sdks/python (#4220) by @app/dependabot
• chore: Bump starlette from 1.0.1 to 1.3.1 in /sdks/python (#4221) by @app/dependabot
• test(sdk/python): stabilize bulk replay polling (#4238) by @igor-kupczynski
• fix(python-sdk): handle empty proto bytes in durable memo ack on replay (#4246) by @chandan-1427

Python SDK 1.33.11

Overview

Fixed

• Fixes a bug in the durable event logic where wrapping child spawns asyncio.gather causes a race condition with causes a future to hang. Added a lock around various send_event calls to synchronize those to prevent the race.

Installation

Install the SDK using pip:

pip install hatchet-sdk

Or using poetry:

poetry add hatchet-sdk

Documentation

For detailed documentation, examples, and best practices, visit:

• Hatchet Documentation
• Examples

What's Changed?

• fix(python): durable event listener send_event race with asyncio.gather (#4233) by @mrkaye97

Python SDK 1.33.10

Overview

Fixed

• Properly suppresses gRPC fork support log lines on startup when fork support is disabled
• Improves logging around worker startup and shutdown
• Improves retry logic around sending step action events to the engine to better handle transient failures and avoid losing events

Installation

Install the SDK using pip:

pip install hatchet-sdk

Or using poetry:

poetry add hatchet-sdk

Documentation

For detailed documentation, examples, and best practices, visit:

• Hatchet Documentation
• Examples

What's Changed?

• fix(python): startup logging, retry behavior on sending step action events (#4219) by @mrkaye97

Python SDK 1.33.9

Overview

Fixed

• Fixes a race condition in the durable event listener where an engine restart can cause the listener to get stuck because of the existence of two separate request queues that are not kept in sync, causing requests to hang indefinitely after being added to the old queue in some cases.

Installation

Install the SDK using pip:

pip install hatchet-sdk

Or using poetry:

poetry add hatchet-sdk

Documentation

For detailed documentation, examples, and best practices, visit:

• Hatchet Documentation
• Examples

What's Changed?

• chore(deps): bump the python-deps group in /sdks/python with 6 updates (#4186) by @app/dependabot
• fix(python, ts): durable listener hanging from race condition (#4196) by @mrkaye97

Ruby SDK 0.3.1

Overview

Fixed

• Fixed an issue where errors raised by child tasks spawned inside a durable parent task were not propagated back to the parent. The parent can now catch the child's error and handle it gracefully.

Installation

Add this line to your application's Gemfile:

gem 'hatchet'

And then execute:

bundle install

Or install it yourself as:

gem install hatchet

Documentation

For detailed documentation, examples, and best practices, visit:

• Hatchet Documentation
• Examples

What's Changed?

Hatchet v0.89.0

Hatchet v0.89.0 introduces a range of updates to the platform, consisting largely of performance improvements and bug fixes to the engine, alongside several user-experience changes to the dashboard.

Highlights

• Hatchet Cloud now consolidates billing at the organization level, providing a single surface for managing billing and resource limits across all tenants in an organization.
• The Hatchet engine and clients can have their minimum TLS version configured via the SERVER_TLS_MIN_VERSION and HATCHET_CLIENT_TLS_MIN_VERSION environment variables, respectively (defaults to 1.3).
• Crons and scheduled runs can now be triggered on demand via the dashboard, rather than waiting for the next scheduled tick.
• Improved engine query performance when filtering runs by status over large histories, particularly when matching rare statuses such as active runs.
• Fixed an engine bug where re-registering a workflow left orphaned cron trigger rows behind, gradually slowing cron scheduling.

What's Changed

Added

• docs: Add support for system theme option v0.88.8 by @BittuBarnwal7479 in #4119
• Cloud organization billing v0.88.3 by @grutt in #4063
• dashboard: Add buttons to trigger crons and scheduled runs immediately v0.88.2 by @mrkaye97 in #4071

Fixed

• engine: Add detach with finalize if there's a pending detach v0.88.8 by @mrkaye97 in #4124
• Tier name v0.88.8 by @grutt in #4122
• dashboard: Flip order of index on v1_runs_olap to improve needle-in-a-haystack query performance v0.88.7 by @mrkaye97 in #4118
• Fail fast when creating partitions concurrently with analyze v0.88.7 by @juliusgeo in #4089
• sdks/go: Filters not being serialised v0.88.7 by @darren-west in #4016
• dashboard: Use sh for dashboard entrypoint v0.88.7 by @BloggerBust in #4108
• Gate managed worker pages v0.88.7 by @AVtheking in #4006
• cli: Improve quickstart e2e failure handling v0.88.7 by @BloggerBust in #4037
• client: Reconnect durable and workflow listeners after stream loss v0.88.7 by @igor-kupczynski in #4077
• Hatchet cloud billing authorization surface v0.88.6 by @grutt in #4079
• Billing UI bugs v0.88.5 by @grutt in #4078
• config: Make TLS minimum version configurable v0.88.4 by @BloggerBust in #4072
• dashboard: Avoid stale tenant exchange tokens v0.88.1 by @igor-kupczynski in #4062
• Cron row accumulation leading to query slowdown v0.88.1 by @juliusgeo in #4028

New Contributors

• @BittuBarnwal7479 made their first contribution in #4119
• @AasheeshLikePanner made their first contribution in #4101
• @AVtheking made their first contribution in #4006

---

🪓 New to Hatchet? See Get started quickly or the full documentation.

Python SDK 1.33.7

Overview

Added

• Added an individual_run_spans_for_bulk_run OpenTelemetry config option. When enabled, a child hatchet.run_workflow span is created for each item in a bulk run (run_workflows), nested under the parent hatchet.run_workflows span, with each item's traceparent pointing at its own span. Defaults to false to preserve the existing span structure.

Fixed

• Fixed a bug where synchronous log calls via asyncio.to_thread (or other threads) could block workers.

Installation

Install the SDK using pip:

pip install hatchet-sdk

Or using poetry:

poetry add hatchet-sdk

Documentation

For detailed documentation, examples, and best practices, visit:

• Hatchet Documentation
• Examples

What's Changed?

• docs: AWS S3 processing example (#3840) by @gregfurman
• fix(python-sdk): make async log sender thread-safe (#3958) by @MicroYui
• fix(otel): create per-item run_workflow span in batch run instrumenta… (#3995) by @Mdev303
• fix: Python test timeouts (#4031) by @juliusgeo
• chore(deps): bump the python-deps group across 3 directories with 1 update (#4056) by @app/dependabot
• chore(deps-dev): bump the python-dev-deps group across 1 directory with 7 updates (#4060) by @app/dependabot
• chore(deps-dev): bump types-requests from 2.33.0.20260503 to 2.33.0.20260518 in /sdks/python (#4061) by @app/dependabot
• docs(cookbooks): add trusted agent SDK guides (#4070) by @BloggerBust
• chore(deps): bump aiohttp from 3.13.5 to 3.14.0 in /sdks/python (#4083) by @app/dependabot
• chore(deps): bump starlette from 1.0.0 to 1.0.1 in /sdks/python (#4086) by @app/dependabot
• chore(deps-dev): bump types-psutil from 7.2.2.20260508 to 7.2.2.20260518 in /sdks/python (#4096) by @app/dependabot
• chore(deps-dev): bump the python-deps group across 1 directory with 4 updates (#4102) by @app/dependabot
• chore(deps-dev): bump boto3 from 1.43.19 to 1.43.24 in /sdks/python in the python-deps group (#4114) by @app/dependabot
• fix: Update Python SDK proto files (#4133) by @juliusgeo

hatchet-cli-0.88.0

Hatchet CLI v0.88.0

Welcome to this new release of the Hatchet CLI!

For full documentation, visit https://docs.hatchet.run/cli

Installation

MacOS, Linux, WSL

curl -fsSL https://install.hatchet.run/install.sh | bash

MacOS (Homebrew)

brew install hatchet-dev/hatchet/hatchet --cask

Manual Installation

Download the appropriate binary for your platform from the assets below.

Verify Installation

hatchet --version

hatchet-cli-0.87.14

Hatchet CLI v0.87.14

Welcome to this new release of the Hatchet CLI!

For full documentation, visit https://docs.hatchet.run/cli

Installation

MacOS, Linux, WSL

curl -fsSL https://install.hatchet.run/install.sh | bash

MacOS (Homebrew)

brew install hatchet-dev/hatchet/hatchet --cask

Manual Installation

Download the appropriate binary for your platform from the assets below.

Verify Installation

hatchet --version

hatchet-cli-0.87.13

Hatchet CLI v0.87.13

Welcome to this new release of the Hatchet CLI!

For full documentation, visit https://docs.hatchet.run/cli

Installation

MacOS, Linux, WSL

curl -fsSL https://install.hatchet.run/install.sh | bash

MacOS (Homebrew)

brew install hatchet-dev/hatchet/hatchet --cask

Manual Installation

Download the appropriate binary for your platform from the assets below.

Verify Installation

hatchet --version