Skip to content

Quick Start

Install the tracker CLI, authenticate, and submit your first run.

Prerequisites

One-time setup. Skip if you already have uv (uv --version) and the Artifactory index configured.

Install uv (if needed):

curl -LsSf https://astral.sh/uv/install.sh | sh

Configure the Natera Artifactory index in ~/.config/uv/uv.toml:

index-url = "https://artifactory.natera.com/artifactory/api/pypi/pypi/simple/"

1. Install

uv tool install workflow-tracker-cli

This installs the tracker binary to ~/.local/bin/. If it's not in your $PATH, add it:

export PATH="$HOME/.local/bin:$PATH"

To upgrade later: uv tool upgrade workflow-tracker-cli

2. Login

tracker auth login

This opens your browser for Google OAuth and stores a Personal Access Token in ~/.tracker.yaml.

Headless machines

Use tracker auth login --use-device-code when you don't have a browser (e.g., EC2 instances).

3. Submit a run

tracker run \
  https://gitlab.natera.com/rd-platform/bioinformatics/infrastructure/nextflow-pipeline-template.git \
  -r master \
  -profile docker,eks,test \
  --outdir s3://natera-platform-sandbox/users/$USER/my-output

The CLI prints a direct link to the run in the Tracker web UI. You can also tail the run from the terminal:

tracker logs RUN_NAME
tracker wait RUN_NAME

What's next