Hera
 |
Hera is the go-to Python SDK to make Argo Workflows simple and intuitive. Easily turn Python functions into containerised templates that run on Kubernetes, with full access to its capabilities. |
|---|
See the Quick Start guide to start using Hera to orchestrate your Argo Workflows!
The Argo was constructed by the shipwright Argus,
and its crew were specially protected by the goddess Hera.
PyPI stats
Repo information
Hera at a glance
from hera.workflows import DAG, Workflow, script
# Turn a function into a reusable "Script template"
# using the script decorator
@script()
def echo(message: str):
print(message)
# Orchestration logic lives *outside* of business logic
with Workflow(
generate_name="dag-diamond-",
entrypoint="diamond",
) as w:
with DAG(name="diamond"):
A = echo(name="A", arguments={"message": "A"})
B = echo(name="B", arguments={"message": "B"})
C = echo(name="C", arguments={"message": "C"})
D = echo(name="D", arguments={"message": "D"})
A >> [B, C] >> D # Define execution order
# Create the workflow directly on your Argo Workflows cluster!
w.create()
Check out the Walkthrough to learn how to construct and submit Argo Workflows with Hera!
Requirements
Hera requires an Argo Workflows server to be deployed to a Kubernetes cluster. To learn how to deploy Argo to your own Kubernetes cluster you can follow the Argo Workflows guide!
Authenticating in Hera
Hera assumes that the Argo server sits behind an authentication layer, so workflow submission requests are authenticated
using a Bearer token on the request. Another option for workflow submission without the authentication layer is using
port forwarding to your Argo server deployment and submitting workflows to localhost:2746.
There are a few ways to authenticate in Hera - read more in the
authentication walkthrough - for now, with the
argo cli tool installed, and the server port-forwarded to localhost:2746, this example will get you up and running:
from hera.workflows import Workflow, Container
from hera.shared import global_config
from hera.auth import ArgoCLITokenGenerator
global_config.host = "http://localhost:2746"
global_config.token = ArgoCLITokenGenerator
with Workflow(generate_name="local-test-", entrypoint="c") as w:
Container(name="c", image="docker/whalesay", command=["cowsay", "hello"])
w.create()
Installation
| Source | Command |
|---|---|
| PyPI | pip install hera |
| GitHub repo | python -m pip install git+https://github.com/argoproj-labs/hera --ignore-installed |
Optional dependencies
yaml
- Install via
hera[yaml] - PyYAML is required for the
yamloutput format, which is accessible viahera.workflows.Workflow.to_yaml(*args, **kwargs). This enables GitOps practices and easier debugging.
cli
- Install via
hera[cli]. The[cli]option installs the extra dependencies including Cappa which is required for the CLI - The CLI aims to enable GitOps practices, easier onboarding to Hera, and a more seamless experience with Argo Workflows.
- It currently supports converting workflows between YAML and Python source codes. See
hera generate yaml --help, andhera generate python --helpfor more information. - The CLI is an experimental feature and subject to change!
async-client
- Install via
hera[async-client]. The[async-client]option installshttpxto allow the use of theasync_*Workflow functions through theAsyncWorkflowsService.
Presentations
- KubeCon/ArgoCon EU 2025 - One Engine To Rule Them All: Unifying Cloud Workloads With Argo Workflows
- KubeCon/ArgoCon NA 2024 - Data Science Workflows Made Easy: Python-Powered Argo for Your Organization
- KubeCon/ArgoCon EU 2024 - Orchestrating Python Functions Natively in Argo Using Hera
More presentations
- KubeCon/ArgoCon NA 2023 - Orchestrating Rocket Simulations with Argo Workflows and Hera
- CNCF TAG App-Delivery @ KubeCon NA 2023 - Automating the Deployment of Data Workloads to Kubernetes with ArgoCD, Argo Workflows, and Hera
- KubeCon/ArgoCon NA 2023 - How to Train an LLM with Argo Workflows and Hera
- KubeCon/ArgoCon EU 2023 - Scaling gene therapy with Argo Workflows and Hera
- DoKC Town Hall #2 - Unsticking ourselves from Glue - Migrating PayIt's Data Pipelines to Argo Workflows and Hera
- Argo Workflows and Events Community Meeting 15 June 2022 - Hera project update
- Argo Workflows and Events Community Meeting 20 Oct 2021 - Hera introductory presentation
Blogs
- Hera Developer Survey 2025
- How To Get the Most out of Hera for Data Science
- Data Validation with Great Expectations and Argo Workflows
More blogs
Contributing
Use one of the following to open the repo in a cloud dev box:
Read more in the contributing guide!
Hera Emeritus Maintainers
These emeritus maintainers dedicated a part of their career to Hera and reviewed code, triaged bugs and pushed the project forward over a substantial period of time. Their contribution is greatly appreciated:
License
Hera is licensed under Apache 2.0. See License for details.
2 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file hera_workflows-7.1.0.tar.gz.
File metadata
- Download URL: hera_workflows-7.1.0.tar.gz
- Upload date:
- Size: 306.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.10.20
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1ac3717098c26a3ee317b33b5753b98e433843351d277646a78c2e7e08fc40d0
|
|
| MD5 |
b020570324b1eb6a1509504896f74a0d
|
|
| BLAKE2b-256 |
a21c1d91535ae90f1095e210adc11216c07d4364d66e99cbb6b8b6d06550a112
|
File details
Details for the file hera_workflows-7.1.0-py3-none-any.whl.
File metadata
- Download URL: hera_workflows-7.1.0-py3-none-any.whl
- Upload date:
- Size: 356.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.10.20
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7898302fd53d5946871f5e71c1b94d7a24224384fb4fabf2b5ff13c599bfffdd
|
|
| MD5 |
1cfeee4b093f47ae0f001133441839b7
|
|
| BLAKE2b-256 |
fa9392025bbc241d9a0b8b24681327a5807c92f661d48daab4541dd0b9822373
|
