SpotWarp v3.4.3 Setup Guide (Zero-Python C-Binary & PyPI)

Get SpotWarp running in 1 minute

Three simple steps. Your credentials stay 100% local — zero cloud key uploads.

Install SpotWarp

1-line universal installer (Zero-Python required)

Run the 1-liner installer or download standalone C-binaries. Python is 100% optional — our standalone binaries run with zero dependencies.

Linux / macOS (1-Liner)

curl -fsSL https://gpu-action.com/install.sh | bash

Windows PowerShell (1-Liner)

irm https://gpu-action.com/install.ps1 | iex

Linux x86_64 (13MB) macOS Apple Silicon (6MB) Windows x64 ZIP (6MB)

Windows users: Download the ZIP, extract it, and run .\spotwarp.exe init in that folder — no installer and no admin rights needed. The binary is not code-signed yet, so SmartScreen may warn on first run: choose More info → Run anyway. You can verify the file first against the published SHA256 checksum.

Standard Python pip (Any OS / Docker)

pip install --upgrade spotwarp

Activate License & Cloud Keys

1-minute local config

Run the 1-minute wizard to enter your SpotWarp License Key (from your receipt email / dashboard). Your Vast.ai and RunPod keys are auto-detected:

terminal (any OS)

spotwarp init

✨ Direct 1-Line Start: You can also pass your license key directly on daemon launch:
spotwarp start --license-key spw_live_your_key_here -d

Start the Guard

instant protection

Run in the foreground or detach as a 24/7 background daemon with -d.

Option A: Foreground Live Console

spotwarp start

Option B: 24/7 Background Daemon

spotwarp start -d

💡 Training Auto-Resume: To automatically resume training on replacement GPUs, add:
spotwarp start --resume-cmd "python train.py --resume"

Daemon Management & Status

cli commands

Check Status

spotwarp status

Stop Daemon

spotwarp stop

Console Output Decoder

what you see

License Verified: Active

GoodYou're authenticated. Zero-downtime protection is live.

Found new active instance: …

GoodRented Spot GPU auto-detected. Continuous delta-sync active.

Monitoring 0 instances

NormalNo active GPU instance running on your Vast.ai or RunPod account yet.

Triggering Failover Protocol

ActionEviction detected. SpotWarp is provisioning a replacement GPU and restoring files.

Troubleshooting

You see	It means
status 401	License key mistyped or concatenated with another key — re-copy it as one piece.
0 instances, GPU rented	`VAST_API_KEY` or `RUNPOD_API_KEY` isn't set in this window — re-run step 2 here.
`export` error	You're in PowerShell — use `$env:` instead.
backups missing	Check `.\backups\<instance_id>\`, or your `--backup-dir` path.