Download the install script

# Download
curl -O
# Change permissions
chmod +x
# Set AWS credentials
export AWS_ACCESS_KEY_ID=***


Cortex runs on Kubernetes and requires access to kubectl. If you don't already have a Kubernetes cluster, eksctl is a simple tool to create and manage one.

We recommend a minimum cluster size of 2 t3.medium AWS instances. Cortex may not run successfully on clusters with less compute resources.

# Install kubectl, eksctl, and aws-iam-authenticator
./ install kubernetes-tools
# Spin up an EKS cluster (this takes ~20 minutes; see for more options)
eksctl create cluster --name=cortex --nodes=2 --node-type=t3.medium

This cluster configuration will cost about $0.29 per hour in AWS fees.

Install the operator

The Cortex operator is a service that runs on Kubernetes, translates declarative configuration into workloads, and orchestrates those workloads on the cluster. Its installation is configurable. For a full list of configuration options please refer to the operator config documentation.

# Install the Cortex operator
./ install operator

Install the CLI

The CLI runs on developer machines (e.g. your laptop) and communicates with the operator.

# Install the Cortex CLI
./ install cli
# Get the operator endpoint
./ get endpoints
# Configure the CLI
cortex configure

Deploy an application

# Clone the Cortex repository
git clone -b 0.3
# Navigate to the iris classification example
cd cortex/examples/iris
# Deploy the application to the cluster
cortex deploy
# View the status of the deployment
cortex status --watch
# Classify a sample
cortex predict iris-type irises.json


# Delete the deployment
$ cortex delete iris

See uninstall if you'd like to uninstall Cortex.