List Workflows
mixtrain workflow listList all workflows in the workspace.
mixtrain workflow listDownload Workflow
mixtrain workflow download <name>Download workflow source files to a local directory for editing.
Options:
| Option | Description |
|---|---|
--dir, -d | Target directory (defaults to ./<name>/) |
--force, -f | Overwrite existing directory |
# Download to default directory (./<name>/)
mixtrain workflow download my-workflow
# Download to custom directory
mixtrain workflow download my-workflow --dir ./local-copy/
# Overwrite existing directory
mixtrain workflow download my-workflow --forceUpload Workflow
mixtrain workflow upload <name> --dir <path>Upload local workflow files to update the workflow on the platform.
Options:
| Option | Description |
|---|---|
--dir, -d | Local directory containing workflow files (required) |
# Upload all files from directory
mixtrain workflow upload my-workflow --dir ./local-copy/
# Typical workflow: download → edit → upload
mixtrain workflow download my-workflow
# ... edit files locally ...
mixtrain workflow upload my-workflow --dir ./my-workflow/Create Workflow
mixtrain workflow create <files...>Create a workflow from files. Supports directories and glob patterns.
Options:
| Option | Description |
|---|---|
--name, -n | Workflow name (defaults to first .py filename) |
--description, -d | Workflow description |
--entrypoint, -e | Entrypoint hint: file path, file:class, or class name |
# Single directory (most common)
mixtrain workflow create ./workflow-dir/
# Multiple files
mixtrain workflow create main.py utils.py config.json
# Glob patterns
mixtrain workflow create "*.py" Dockerfile --name my-workflow
# With explicit name
mixtrain workflow create train.py --name training-job -d "PyTorch training"
# With --entrypoint to select a specific class from a multi-class directory:
# File only - scan only this file, must contain exactly one MixFlow class
mixtrain workflow create . --name train --entrypoint workflows/train.py
# File:Class - select a specific class inside a file
mixtrain workflow create . --name train --entrypoint workflows/train.py:TrainFlow
# Class-only - class name must be unique across all uploaded files
mixtrain workflow create . --name pipeline --entrypoint DataPipelineEntrypoint hints
The --entrypoint (or -e) option lets you create a workflow from a specific class
when your source directory contains multiple MixFlow classes. It supports three formats:
| Format | Example | Behaviour |
|---|---|---|
| File only | --entrypoint train.py | Scans only that file. Must contain exactly one MixFlow class. |
| File:Class | --entrypoint train.py:TrainFlow | Uses the named class in that file. |
| Class only | --entrypoint DataPipeline | Scans all files for a class with that name. Must be unique. |
Without --entrypoint, the historic behaviour applies: all .py files are scanned,
and exactly one MixFlow class must exist across the entire upload.
Run Workflow
mixtrain workflow run <name>Run a workflow. Streams logs in real-time until completion.
Options:
| Option | Description |
|---|---|
--input, -i | Input JSON or path to JSON file |
--detach, -d | Start run and exit without streaming logs |
mixtrain workflow run training-job
mixtrain workflow run training-job --input '{"epochs": 20, "batch_size": 64}'
mixtrain workflow run training-job -i config.json --detachView Workflow
mixtrain workflow get <name>View workflow details and recent runs.
mixtrain workflow get training-jobList Runs
mixtrain workflow runs <name>List all runs for a workflow.
mixtrain workflow runs training-jobEdit Workflow
mixtrain workflow edit <name>View and modify workflow files and metadata.
Options:
| Option | Description |
|---|---|
--file, -f | Edit file in $EDITOR |
--view, -v | View file contents |
--delete, -d | Delete file/folder at this path |
--add, -a | Add local files to workflow |
--name, -n | Rename workflow |
--description, -D | Update description |
--yes, -y | Skip confirmation prompts |
mixtrain workflow edit my-workflow # List all files
mixtrain workflow edit my-workflow -v main.py # View file contents
mixtrain workflow edit my-workflow -f main.py # Edit file in $EDITOR
mixtrain workflow edit my-workflow --add ./src/ # Add files
mixtrain workflow edit my-workflow -d old.py # Delete file
mixtrain workflow edit my-workflow -n new-name # Rename workflow
mixtrain workflow edit my-workflow -D "Updated" # Update descriptionCancel Run
mixtrain workflow cancel <name> <run_number>Cancel a running workflow.
mixtrain workflow cancel training-job 5Delete Workflow
mixtrain workflow delete <name>Delete a workflow.
Options:
| Option | Description |
|---|---|
--yes, -y | Skip confirmation |
mixtrain workflow delete training-job
mixtrain workflow delete training-job --yes