Simpleflow
Simpleflow is a Python library that provides abstractions to write programs in the distributed dataflow paradigm. It coordinates the execution of distributed tasks with Amazon SWF.
It relies on futures to describe the dependencies between tasks. A Future object
models the asynchronous execution of a computation that may end. It tries to mimic
the interface of the Python concurrent.futures library.
Features
- Provides a
Futureabstraction to define dependencies between tasks. - Define asynchronous tasks from callables.
- Handle workflows with Amazon SWF.
- Implement replay behavior like the Amazon Flow framework.
- Handle retry of tasks that failed.
- Automatically register decorated tasks.
- Encodes/decodes large fields to S3 objects transparently (aka "jumbo fields").
- Handle the completion of a decision with more than 100 tasks.
- Provides a local executor to check a workflow without Amazon SWF (see
simpleflow --localcommand). - Provides decider and activity worker process for execution with Amazon SWF.
- Ships with the
simpleflowcommand.simpleflow --helpfor more information about the commands it supports.
You can read more in the Features section of the documentation.
Overview
Please read and even run the demo script to have a quick glance of
simpleflow commands. To run the demo you will need to start decider
and activity worker processes.
Start a decider with:
$ PYTHONPATH=$PWD simpleflow decider.start --domain TestDomain --task-list test examples.basic.BasicWorkflow
Start an activity worker with:
$ simpleflow worker.start --domain TestDomain --task-list quickstart
Then execute ./extras/demo.
More information
Read the main documentation at https://botify-labs.github.io/simpleflow/.
Release files for simpleflow 0.36.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| simpleflow-0.36.0.tar.gz | 114.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| simpleflow-0.36.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 272.5 kB
Release files / simpleflow-0.36.0.tar.gz
| Download URL | simpleflow-0.36.0.tar.gz |
|---|---|
| Size | 114.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9ceb5d3f9af40af569a680b45f15e69876bbf3d2701e7498e291663fa1d762ba
|
|
BLAKE2b-256 checksum How to use checksums |
255a61d925910d5eec65688fbbdf8b18946b099b45bb13296a086435e31db75f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 1, 2026.
Transparency logRelease files / simpleflow-0.36.0-py3-none-any.whl
| Download URL | simpleflow-0.36.0-py3-none-any.whl |
|---|---|
| Size | 158.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
880eadc6e0f701592999fddd9c2ee87e518be817698e810b4d5ffab466655191
|
|
BLAKE2b-256 checksum How to use checksums |
b88c464bc69eb4bc3fbecc5e854b0d011f6562fcf12977d85b2142bf2b67895a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 1, 2026.
Transparency log
