Durable YAML workflows executed on Temporal.
Describe your workflow in YAML and implement its actions in Python or call an existing service. Temporal keeps track of progress, retries, and long-running waits. Justflow validates the workflow, manages its definitions, and provides APIs to start and inspect runs.
- Multi-step processes with branches, parallel work, child workflows, and failure handling.
- Scheduled jobs, event-driven workflows, and appointment reminders.
- Customer batches and individual customer workflows within a tenant's scope.
- Workflows that call HTTPS, gRPC, or SQS-backed services and use resources such as S3 and PostgreSQL.
- Your own dashboard using the public API, or an installation with the optional admin panel.
See the changelog for the full feature list and beta limitations.
The prime_stats example runs a complete workflow on your machine.
git clone https://github.com/nickyua/justflow.git
cd justflow
python3 -m venv .venv
.venv/bin/pip install -e ".[dev]" -e examples/prime_stats
.venv/bin/python -m justflow validate --config-dir examples/prime_stats/configs
.venv/bin/python -m justflow run prime_stats --config-dir examples/prime_stats/configs --param n=20 --param seed=42This command starts a temporary Temporal development server and stops it after the workflow finishes. Use a persistent Temporal service for production.
pip install justflow
pip install "justflow[control,admin]"Core includes direct and HTTPS transports. Optional extras are aws, grpc, postgres, redis,
control, admin, and all. Justflow supports Python 3.11–3.14.
- Export versioned JSON Schemas for your editor with
justflow schema export --output .justflow/schemas. - Export the OpenAPI 3.1 document for dashboard and automation clients with
justflow api schema export --output .justflow/api. - The optional admin panel is a separate package that uses these same tenant-scoped APIs.
- Your application supplies authentication, integrations, storage, and Temporal credentials through typed Python interfaces.
- Getting started
- Concepts and guarantees
- Workflow and trigger authoring
- Integrations and custom providers
- Deployment, security, configuration, and troubleshooting
- Local runtime and Docker Compose
- AWS deployment
- AWS data services and ECS connectivity
- CLI, settings, schemas, OpenAPI, errors, and Python API
- Upgrade guide, limitations, and support
.venv/bin/pip install -e packages/justflow-admin
npm --prefix ui/admin ci
make checkThis runs frontend checks, formatting, typing, unit/integration/replay/sandbox tests, documentation checks, and package installation tests. See CONTRIBUTING.md.
0.1 is beta software. Read the support policy, security policy, changelog, and limitations before production adoption.
Licensed under the Apache License 2.0; attribution details are in NOTICE.