Argo Workflows

Quick Start

What's New?

Find out on our blog and changelog.

Breaking Changes and Known Issues

Check the upgrading guide and search for existing issues on GitHub.

Installation

CLI

Mac / Linux

Available via curl

# Detect OS
ARGO_OS="darwin"
if [[ "$(uname -s)" != "Darwin" ]]; then
  ARGO_OS="linux"
fi

# Download the binary
curl -sLO "https://github.com/argoproj/argo-workflows/releases/download/v4.0.8/argo-$ARGO_OS-amd64.gz"

# Unzip
gunzip "argo-$ARGO_OS-amd64.gz"

# Make binary executable
chmod +x "argo-$ARGO_OS-amd64"

# Move binary to path
mv "./argo-$ARGO_OS-amd64" /usr/local/bin/argo

# Test installation
argo version

Controller and Server

kubectl create namespace argo
kubectl apply -n argo -f https://github.com/argoproj/argo-workflows/releases/download/v4.0.8/install.yaml

<!-- markdownlint-disable-next-line MD041 -->

Security Status

OpenSSF Best Practices

OpenSSF Scorecard

FOSSA License Status

Slack

X Follow

LinkedIn

Bluesky

Release Version

Artifact HUB

What is Argo Workflows?

Argo Workflows is an open source container-native workflow engine for orchestrating parallel jobs on Kubernetes.

Argo Workflows is implemented as a Kubernetes CRD (Custom Resource Definition).

• Define workflows where each step is a container.
• Model multi-step workflows as a sequence of tasks or capture the dependencies between tasks using a directed acyclic graph (DAG).
• Easily run compute intensive jobs for machine learning or data processing in a fraction of the time using Argo Workflows on Kubernetes.

Argo is a Cloud Native Computing Foundation (CNCF) graduated project.

Use Cases

• Machine Learning pipelines
• Data and batch processing
• Infrastructure automation
• CI/CD
• Other use cases

Why Argo Workflows?

• Argo Workflows is the most popular workflow execution engine for Kubernetes.
• Light-weight, scalable, and easier to use.
• Including for Python users through the Hera Python SDK for Argo Workflows.
• Designed from the ground up for containers without the overhead and limitations of legacy VM and server-based environments.
• Cloud agnostic and can run on any Kubernetes cluster.

Read what people said in our latest survey

Try Argo Workflows

You can try Argo Workflows via one of the following:

1. Interactive Training Material
2. Access the demo environment

Screenshot

Who uses Argo Workflows?

About 200+ organizations are officially using Argo Workflows

Ecosystem

Just some of the projects that use or rely on Argo Workflows (complete list here):

• Argo Events
• Hera
• Katib
• Kedro
• Kubeflow Pipelines
• Netflix Metaflow
• Piper
• Seldon
• SQLFlow

Client Libraries

Check out our Java, Golang, Python (Hera), and Typescript (Juno) clients.

Quickstart

• Get started here
• Walk-through examples

Documentation

View the docs

Features

An incomplete list of features Argo Workflows provides:

• UI to visualize and manage Workflows
• Artifact support (S3, Artifactory, Alibaba Cloud OSS, Azure Blob Storage, HTTP, Git, GCS, raw, plugins)
• Workflow templating to store commonly used Workflows in the cluster
• Archiving Workflows after executing for later access
• Scheduled workflows using cron
• Server interface with REST API (HTTP and GRPC)
• DAG or Steps based declaration of workflows
• Step level input & outputs (artifacts/parameters)
• Loops
• Parameterization
• Conditionals
• Timeouts (step & workflow level)
• Retry (step & workflow level)
• Resubmit (memoized)
• Suspend & Resume
• Cancellation
• K8s resource orchestration
• Exit Hooks (notifications, cleanup)
• Garbage collection of completed workflow
• Scheduling (affinity/tolerations/node selectors)
• Volumes (ephemeral/existing)
• Parallelism limits
• Daemoned steps
• DinD (docker-in-docker)
• Script steps
• Event emission
• Prometheus metrics
• Multiple executors
• Multiple pod and workflow garbage collection strategies
• Automatically calculated resource usage per step
• Java, Golang, Python (Hera), and Typescript (Juno) SDKs
• Pod Disruption Budget support
• Single-sign on (OAuth2/OIDC)
• Webhook triggering
• CLI
• Out-of-the box and custom Prometheus metrics
• Windows container support
• Embedded widgets
• Multiplex log viewer

Community Meetings

We host monthly community meetings where we and the community showcase demos and discuss the current and future state of the project. Feel free to join us!

For Community Meeting information, minutes and recordings, please see here.

Participation in Argo Workflows is governed by the CNCF Code of Conduct

Community Blogs and Presentations

• Awesome-Argo: A Curated List of Awesome Projects and Resources Related to Argo
• Automation of Everything - How To Combine Argo Events, Workflows & Pipelines, CD, and Rollouts
• Argo Workflows and Pipelines - CI/CD, Machine Learning, and Other Kubernetes Workflows
• Argo Ansible role: Provisioning Argo Workflows on OpenShift
• Argo Workflows vs Apache Airflow
• Beyond Prototypes: Production-Ready ML Systems with Metaflow and Argo
• CI/CD with Argo on Kubernetes
• Define Your CI/CD Pipeline with Argo Workflows
• Distributed Machine Learning Patterns from Manning Publication
• Engineering Cloud Native AI Platform
• Managing Thousands of Automatic Machine Learning Experiments with Argo and Katib
• Autonomous Driving Data Pipelines Reconstruction With Argo Workflows
• Revolutionizing Scientific Simulations with Argo Workflows
• Running Argo Workflows Across Multiple Kubernetes Clusters
• Scaling Kubernetes: Best Practices for Managing Large-Scale Batch Jobs with Spark and Argo Workflow
• Open Source Model Management Roundup: Polyaxon, Argo, and Seldon
• Producing 200 OpenStreetMap extracts in 35 minutes using a scalable data workflow
• Production-Ready AI Platform on Kubernetes
• Argo integration review
• TGI Kubernetes with Joe Beda: Argo workflow system

Project Resources

• Argo Project GitHub organization
• Argo Website
• Argo Slack
• Contributing
• Governance
• Code of Conduct

Security

See SECURITY.md.

Generative AI

Contributions using generative AI tools must follow the Argo project Generative AI policy.