Gradient Docs
Gradient HomeHelp DeskCommunitySign up free
Gradient Next
Gradient Next
  • About Gradient
  • Get Started
    • Quick Start
      • Install the Gradient CLI
    • Core Concepts
    • Organizing Projects
      • Secrets
      • Storing an API key as a Secret
    • Tutorials
      • Gradient Notebooks Tutorial
      • Gradient Workflows Tutorial
      • Gradient Deployments Tutorial
    • FAQ
    • Common Errors
  • Gradient Platform
    • Gradient Notebooks
      • Runtimes
      • Files and storage
      • Machines
      • Terminal
      • Shortcuts
      • Sharing
      • TensorBoard
      • Run on Gradient
    • Gradient Workflows
      • Basic operations
      • Understanding Inputs & Outputs
      • Workflow Spec
      • Gradient Actions
      • Environment Variables
      • Using YAML for Data Science
    • Gradient Deployments
      • Basic operations
      • Deployment Spec
  • Artifacts
    • Container Management
      • Custom Containers
    • Data
      • Versioned Data
        • Public Datasets Repository
        • Storage Providers
      • Persistent Storage
    • Models
      • Managing Models
        • Model Types & Metadata
        • Public Models
    • Code
    • Metrics
      • Push Metrics
      • View & Query Metrics
  • Gradient Cluster
    • Overview
      • Setup
        • Managed Private Clusters
        • Self-Hosted Clusters
          • Pre-installation steps
          • Gradient Installer CLI
          • Terraform
            • Pre-installation steps
            • Install on AWS
            • Install on bare metal / VMs
            • Install on NVIDIA DGX
          • Let's Encrypt DNS Providers
          • Updating your cluster
      • Usage
  • More
    • SDK
      • Projects Client
      • Models Client
      • Deployments Client
      • Workflows Client
      • SDK Examples
      • Full SDK Reference
    • Machine Types
      • Machine Tiers
      • Free Machines (Free Tier)
    • Your Account
      • Teams
        • Creating a Team
        • Upgrading to a Team Plan
      • Hotkeys
      • Billing & Subscriptions
        • Storage Billing
      • Public Profiles
    • Release notes
    • Roadmap
Powered by GitBook
On this page
  • Overview
  • Where to start
  • Key Terminology
  1. Gradient Platform

Gradient Workflows

Gradient Workflows provides a simple way to automate machine learning tasks.

PreviousRun on GradientNextBasic operations

Last updated 3 years ago

Overview

Gradient Workflows is a new and powerful way to build-out machine learning applications. Workflows utilize style syntax via files to easily create powerful automation.

Workflows is based on the , which is a container-native continuous delivery tool for Kubernetes, and makes it easy to build complex and scalable projects with an arbitrary number of discrete steps.

Workflows is used by ML Engineers to build-out deterministic machine learning pipelines.

Where to start

The best tutorial is the canonical Gradient Workflows Tutorial:

Key Terminology

  • Workflow: a named or unnamed entity that belongs to a team and project

    • Named workflows can be re-run with a default workflow spec, or be passed a new spec every time

    • Jobs can define inputs, outputs, and their own environment variables

    • Jobs can require other jobs via "needs" and collect/pass info between jobs

    • Jobs can be implemented with an action via "use"

    • Actions can receive parameters (e.g., args, image) within the job step via the "with" argument

    • E.g., container@v1 action = run a container, load inputs, and produce outputs

    • The most basic run requires a workflowId and clusterId - most will also include a workflowSpec, and the inputs to be passed into the workflow

: a YAML list of jobs that is converted into an Argo template and run on the Gradient distributed runtime engine.

: self-contained part of a workflow spec that is similar to an Argo step

: a self-contained, composable set of code building blocks that can perform specific actions within a machine learning project.

: the implementation of a workflow

The workflow run contains everything needed for the workflow to actually be executed, i.e., what (workflowId), where (clusterId), how (workflowSpec), with (, etc.)

Gradient Workflows Tutorial
Workflow Spec
Action
GitHub-action
YAML
Argo runtime engine
Examining the logs from a simple workflow.
Gradient Workflows — Automate from idea to production
Job
Workflow Run
inputs