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 yaml output format, which is accessible via hera.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, and hera generate python --help for more information.
The CLI is an experimental feature and subject to change!

`async-client`

Install via hera[async-client]. The [async-client] option installs httpx to allow the use of the async_* Workflow functions through the AsyncWorkflowsService.

Presentations

More presentations

Blogs

More blogs

Contributing

Use one of the following to open the repo in a cloud dev box:

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:

Flaviu Vadan

License

Hera is licensed under Apache 2.0. See License for details.

Metadata

Release files for hera-workflows 7.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hera-workflows 7.1.0
File	Size	Uploaded
hera_workflows-7.1.0.tar.gz	306.9 kB	Aug 18, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for hera-workflows 7.1.0
File	Interpreter	ABI	Platform	Reset
hera_workflows-7.1.0-py3-none-any.whl 356.6 kB Aug 18, 2026	Python 3	none	any	Details

Total release size: 663.5 kB

Release files / hera_workflows-7.1.0.tar.gz

Download URL	hera_workflows-7.1.0.tar.gz
Size	306.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`1ac3717098c26a3ee317b33b5753b98e433843351d277646a78c2e7e08fc40d0`
BLAKE2b-256 checksum How to use checksums	`a21c1d91535ae90f1095e210adc11216c07d4364d66e99cbb6b8b6d06550a112`
Upload date	Aug 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.10.20`

Release files / hera_workflows-7.1.0-py3-none-any.whl

Download URL	hera_workflows-7.1.0-py3-none-any.whl
Size	356.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7898302fd53d5946871f5e71c1b94d7a24224384fb4fabf2b5ff13c599bfffdd`
BLAKE2b-256 checksum How to use checksums	`fa9392025bbc241d9a0b8b24681327a5807c92f661d48daab4541dd0b9822373`
Upload date	Aug 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.10.20`