mirror of https://github.com/hatchet-dev/hatchet.git synced 2026-01-03 15:19:44 -06:00

Files

matt c6e154fd03 Feat: OLAP Payloads (#2410 )

* feat: olap payloads table

* feat: olap queue messages for payload puts

* feat: wire up writes on task write

* driveby: add + ignore psql-connect

* fix: down migration

* fix: use external id for pk

* fix: insert query

* fix: more external ids

* fix: bit more cleanup

* feat: dags

* fix: the rest of the refs

* fix: placeholder uuid

* fix: write external ids

* feat: wire up messages over the queue

* fix: panic

* Revert "fix: panic"

This reverts commit c0adccf2ea.

* Revert "feat: wire up messages over the queue"

This reverts commit 36f425f3c1.

* fix: rm unused method

* fix: rm more

* fix: rm cruft

* feat: wire up failures

* feat: start wiring up completed events

* fix: more wiring

* fix: finish wiring up completed event payloads

* fix: lint

* feat: start wiring up external ids in the core

* feat: olap pub

* fix: add returning

* fix: wiring

* debug: log lines for pubs

* fix: external id writes

* Revert "debug: log lines for pubs"

This reverts commit fe430840bd.

* fix: rm sample

* debug: rm pub buffer param

* Revert "debug: rm pub buffer param"

This reverts commit b42a5cacbb.

* debug: stuck queries

* debug: more logs

* debug: yet more logs

* fix: rename BulkRetrieve -> Retrieve

* chore: lint

* fix: naming

* fix: conn leak in putpayloads

* fix: revert debug

* Revert "debug: more logs"

This reverts commit 95da7de64f.

* Revert "debug: stuck queries"

This reverts commit 8fda64adc4.

* feat: improve getters, olap getter

* fix: key type

* feat: first pass at pulling olap payloads from the payload store

* fix: start fixing bugs

* fix: start reworking `includePayloads` param

* fix: include payloads wiring

* feat: analyze for payloads

* fix: simplify writes more + write event payloads

* feat: read out event payloads

* feat: env vars for dual writes

* refactor: clean up task prop drilling a bit

* feat: add include payloads params to python for tests

* fix: tx commit

* fix: dual writes

* fix: not null constraint

* fix: one more

* debug: logging

* fix: more debugging, tweak function sig

* fix: function sig

* fix: refs

* debug: more logging

* debug: more logging

* debug: fix condition

* debug: overwrite properly

* fix: revert debug

* fix: rm more drilling

* fix: comments

* fix: partitioning jobs

* chore: ver

* fix: bug, docs

* hack: dummy id and inserted at for payload offloads

* fix: bug

* fix: no need to handle offloads for task event data

* hack: jitter + current ts

* fix: short circuit

* fix: offload payloads in a tx

* fix: uncomment sampling

* fix: don't offload if external store is disabled

* chore: gen sqlc

* fix: migration

* fix: start reworking types

* fix: couple more

* fix: rm unused code

* fix: drill includePayloads down again

* fix: silence annoying error in some cases

* fix: always store payloads

* debug: use workflow run id for input

* fix: improve logging

* debug: logging on retrieve

* debug: task input

* fix: use correct field

* debug: write even null payloads to limit errors

* debug: hide error lines

* fix: quieting more errors

* fix: duplicate example names, remove print lines

* debug: add logging for olap event writes

* hack: immediate event offloads and cutovers

* fix: rm log line

* fix: import

* fix: short circuit events

* fix: duped names

2025-10-20 09:09:49 -04:00

docs

Feat: Scheduled run detail view, bulk cancel / replay with pagination helper (#2416 )

2025-10-15 11:36:45 -04:00

examples

Feat: OLAP Payloads (#2410 )

2025-10-20 09:09:49 -04:00

hatchet_sdk

Feat: OLAP Payloads (#2410 )

2025-10-20 09:09:49 -04:00

tests

[Python] Feat: Dependency Injection, Improved error handling (#2067 )

2025-08-11 23:10:44 -04:00

.gitignore

feat: v1 engine (#1318 )

2025-03-11 14:57:13 -04:00

apply_patches.py

Feat: Misc. Python improvements + Streaming Improvements (#1846 )

2025-06-25 10:11:01 -04:00

CHANGELOG.md

Feat: OLAP Payloads (#2410 )

2025-10-20 09:09:49 -04:00

conftest.py

Feat: Misc. Python improvements + Streaming Improvements (#1846 )

2025-06-25 10:11:01 -04:00

generate.sh

Fix: Streaming + Misc SDK Fixes (#1903 )

2025-06-26 17:42:34 -04:00

hot-reload.sh

feat: v1 engine (#1318 )

2025-03-11 14:57:13 -04:00

lint.sh

Feat: Python SDK Documentation, Part I (#1567 )

2025-04-18 15:34:07 -04:00

mkdocs.yml

Feat: Next UI improvements, filters improvements, Langfuse docs, tenant getter, workflow status getter (#1801 )

2025-06-10 11:48:31 -04:00

poetry.lock

[Python]: Removes the v0 SDK (#2330 )

2025-09-24 10:38:06 -04:00

publish.sh

feat: v1 engine (#1318 )

2025-03-11 14:57:13 -04:00

pyproject.toml

Feat: Scheduled run detail view, bulk cancel / replay with pagination helper (#2416 )

2025-10-15 11:36:45 -04:00

README.md

Wip consistent naming (#1480 )

2025-04-03 11:27:19 -04:00

README.md

Hatchet Python SDK

This is the official Python SDK for Hatchet, a distributed, fault-tolerant task queue. The SDK allows you to easily integrate Hatchet's task scheduling and workflow orchestration capabilities into your Python applications.

Installation

Install the SDK using pip:

pip install hatchet-sdk

Or using poetry:

poetry add hatchet-sdk

Quick Start

For examples of how to use the Hatchet Python SDK, including worker setup and task execution, please see our official documentation.

Features

🔄 Workflow Orchestration: Define complex workflows with dependencies and parallel execution
🔁 Automatic Retries: Configure retry policies for handling transient failures
📊 Observability: Track workflow progress and monitor execution metrics
⏰ Scheduling: Schedule workflows to run at specific times or on a recurring basis
🔄 Event-Driven: Trigger workflows based on events in your system

Documentation

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

Contributing

We welcome contributions! Please check out our contributing guidelines and join our Discord community for discussions and support.

License

This SDK is released under the MIT License. See LICENSE for details.