runctl 0.1.1

ML training orchestration CLI for AWS EC2, RunPod, and local environments
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

# Modern training orchestration helpers (train-ops)

# Default recipe
default:
    @just --list

# Build
build:
    cargo build --release

# Install
install: build
    cargo install --path .

# Run tests
test:
    cargo test -- --nocapture

# Lint
lint:
    cargo clippy -- -D warnings
    cargo fmt --check
    @echo "Checking shell scripts..."
    @shellcheck examples/*.sh scripts/*.sh 2>/dev/null || echo "Note: Install shellcheck with 'brew install shellcheck' for shell script linting"
    @echo "Checking Dockerfiles..."
    @find . -name "Dockerfile*" -o -name "*.dockerfile" 2>/dev/null | xargs -r hadolint 2>/dev/null || echo "Note: Install hadolint with 'brew install hadolint' for Dockerfile linting"

# Format
fmt:
    cargo fmt

# Quick dev build
dev:
    cargo build

# Run CLI
run *args:
    cargo run -- {{args}}

# Initialize new project
init:
    cargo run -- init

# Example: Train locally
train-local script="training/train.py":
    cargo run -- local {{script}} --verbose

# Example: Create RunPod pod
runpod-create:
    cargo run -- runpod create --gpu "NVIDIA GeForce RTX 4080 SUPER"

# Example: Train on RunPod
runpod-train pod_id script="training/train.py":
    cargo run -- runpod train {{pod_id}} {{script}}

# Example: Monitor training
monitor log="training.log":
    cargo run -- monitor --log {{log}} --follow

# Example: List checkpoints
checkpoints:
    cargo run -- checkpoint list checkpoints/

# Clean build artifacts
clean:
    cargo clean
    @rm -rf target/

# Check for updates
update:
    cargo update

# Generate docs
docs:
    cargo doc --open --no-deps

# Run with tracing
trace *args:
    RUST_LOG=debug cargo run -- {{args}}

# Lint shell scripts
shellcheck:
    @echo "Checking shell scripts with shellcheck..."
    @shellcheck examples/*.sh scripts/*.sh || echo "Some issues found. Run 'shellcheck examples/*.sh scripts/*.sh' for details."

# Format shell scripts (using shfmt if available)
shfmt:
    @if command -v shfmt >/dev/null 2>&1; then \
        shfmt -w examples/*.sh scripts/*.sh; \
        echo "Formatted shell scripts"; \
    else \
        echo "shfmt not installed. Install with: brew install shfmt"; \
    fi

# Lint Dockerfiles
hadolint:
    @echo "Checking Dockerfiles with hadolint..."
    @if find . -name "Dockerfile*" -o -name "*.dockerfile" 2>/dev/null | grep -q .; then \
        find . -name "Dockerfile*" -o -name "*.dockerfile" 2>/dev/null | xargs hadolint || echo "Some issues found. Run 'hadolint Dockerfile' for details."; \
    else \
        echo "No Dockerfiles found to lint"; \
    fi