hera-workflows
Hera makes Python code easy to orchestrate on Argo Workflows through native Python integrations. It lets you construct and submit your Workflows entirely in Python.
Decision gist · record as of 2026-08-14
Yes, if you have an Argo Workflows cluster running on Kubernetes and want to define workflows in Python instead of YAML. The package is actively maintained, has no known vulnerabilities, low install friction, and a permissive license. It's production-stable (Development Status 5) and supports current Python versions (3.10–3.14). Install only if you already operate Argo Workflows; it is not a standalone orchestration tool.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires an Argo Workflows server deployed to a Kubernetes cluster and network access to its API endpoint (typically via port-forwarding or authenticated HTTP).
- Low friction install with three stable runtime dependencies (pydantic, requests, typing-extensions).
- Active maintenance with recent releases; last commit 2026-08-09 and 927 repository stars indicate ongoing development.
License · maintenance · safety
Apache-2.0 (permissive) — Apache 2.0 permissive license allows free use, modification, and distribution with minimal restrictions; suitable for both open-source and commercial projects.
last release 2026-06-18 (57 days) · last repo commit 2026-08-09 · 927 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 147,368 downloads/mo, #11,068 on PyPI
Alternatives
Verify before relying
pip install hera-workflows
from hera.workflows import Workflow, script
from hera.shared import global_config
from hera.auth import ArgoCLITokenGenerator
global_config.host = "http://localhost:2746"
global_config.token = ArgoCLITokenGenerator
@script()
def hello(name: str):
print(f"Hello {name}")
with Workflow(generate_name="test-", entrypoint="hello") as w:
hello(name="hello", arguments={"name": "World"})
w.create()- Whether the package's optional dependencies (yaml, cli, async-client) are necessary for typical workflows or only for advanced use cases.
- Performance characteristics and scalability limits when orchestrating large numbers of tasks or complex DAGs.
What it is and what it does
Hera is a Python SDK that bridges Python code and Argo Workflows, a Kubernetes-native workflow engine. It lets you define containerized workflow templates using Python decorators and functions, then submit them directly to an Argo server running on Kubernetes. Instead of writing YAML manifests, you write Python—functions become reusable script templates, and orchestration logic (task dependencies, parallelism, conditional execution) lives in Python code outside your business logic. The SDK handles the translation to Argo's workflow format and manages submission via HTTP requests to your Argo server.
Typical usage involves decorating Python functions with @script(), composing them into DAGs or other workflow patterns, and calling w.create() to submit. Hera depends on pydantic for validation, requests for HTTP communication with the Argo server, and typing-extensions for runtime type hints. It requires an existing Argo Workflows deployment on a Kubernetes cluster and authentication credentials (typically a Bearer token or port-forwarded access).
Use it for
- Define multi-step data pipelines in Python and run them on Kubernetes without writing YAML workflow manifests.
- Orchestrate containerized ML training jobs with task dependencies, parallelism, and conditional logic.
- Build GitOps-friendly workflows by generating YAML from Python code for version control and review.
- Automate complex scientific computations or simulations across Kubernetes clusters using Python-native syntax.
- Enable data science teams to express workflow logic in Python while leveraging Kubernetes infrastructure.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you have an Argo Workflows cluster running on Kubernetes and want to define workflows in Python instead of YAML.
The package is actively maintained, has no known vulnerabilities, low install friction, and a permissive license. It's production-stable (Development Status 5) and supports current Python versions (3.10–3.14). Install only if you already operate Argo Workflows; it is not a standalone orchestration tool.
Install
hera-workflows on PyPI
Before you install
Low friction install with three stable runtime dependencies (pydantic, requests, typing-extensions). Active maintenance with recent releases; last commit 2026-08-09 and 927 repository stars indicate ongoing development.
Requires an Argo Workflows server deployed to a Kubernetes cluster and network access to its API endpoint (typically via port-forwarding or authenticated HTTP).
License in practice
Apache 2.0 permissive license allows free use, modification, and distribution with minimal restrictions; suitable for both open-source and commercial projects.
Quickstart
pip install hera-workflows
from hera.workflows import Workflow, script
from hera.shared import global_config
from hera.auth import ArgoCLITokenGenerator
global_config.host = "http://localhost:2746"
global_config.token = ArgoCLITokenGenerator
@script()
def hello(name: str):
print(f"Hello {name}")
with Workflow(generate_name="test-", entrypoint="hello") as w:
hello(name="hello", arguments={"name": "World"})
w.create()Verify before relying
- Whether the package's optional dependencies (yaml, cli, async-client) are necessary for typical workflows or only for advanced use cases.
- Performance characteristics and scalability limits when orchestrating large numbers of tasks or complex DAGs.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release <4,>=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packagespydanticrequeststyping-extensions |
| Maintenance | Actively maintained 57 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 147,368 / month, #11,068 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersIntended Audience :: Science/ResearchLicense :: OSI Approved :: Apache Software LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Scientific/Engineering |
Evidence: hera_workflows-7.0.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “argo workflows python sdk”
- hera-workflowsHera is a Python SDK that turns Python functions into Argo Workflows…
- argo-workflowsProvides Python API bindings for Argo Workflows, enabling…
- heraHera is a Python SDK that turns Python functions into Argo Workflows…
Give your agent the search over MCP, or paste the wish link into any chat.
More Scientific/Engineering packages
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
pandas provides fast, flexible data structures (Series and DataFrame) for loading, cleaning, transforming, and analyzing labeled or relational data in Python.
scipy provides numerical algorithms for mathematics, science, and engineering—including optimization, integration, linear algebra, Fourier transforms, signal and image processing, and ODE solvers—built on numpy arrays.
scikit-learn provides a comprehensive Python library for supervised and unsupervised machine learning, including classification, regression, clustering, dimensionality reduction, and model evaluation tools built on NumPy and SciPy.
Install it if you need to train, evaluate, or deploy supervised or unsupervised learning models.
dill extends Python's pickle module to serialize and deserialize a much wider range of Python objects, including functions, lambdas, classes, and interpreter sessions, to byte streams for storage or network transmission.
Multiprocess is an enhanced fork of Python's standard multiprocessing library that uses dill for better serialization, allowing you to spawn processes with a threading-like API and share complex objects between them.
Install it if you use multiprocessing and encounter pickle serialization limits with lambdas or complex objects.
See also argo-workflows · dagger-io · hera · apache-airflow-providers-docker · apache-airflow-task-sdk · kfp-pipeline-spec · kfp-server-api · apache-airflow-core · prefect-docker · dagster-celery-k8s