.py file to Wherobots Cloud from the Command Palette with configurable runtime,
region, timeout, and arguments. Monitor progress and review results alongside your code.
TL;DR — Quickstart
TL;DR — Quickstart
- Open a saved
.pyfile in VS Code. - Open the Command Palette (⌘ + ⇧ + P) and run
Wherobots: Submit Job. - Confirm runtime, region, and timeout in the submission form, then submit.
- Click Open Job in the success notification to track the run in the Wherobots Cloud Console.
Before you start
Ensure you have the following:- The Wherobots VS Code Extension installed and configured
- A saved Python script (
.pyfile) ready to submit as a job run
Submit a job
Confirm job options in the submission form — including runtime size, region, arguments, and timeout.
Inline job configuration
You can provide job defaults directly in your Python file using special comments. The extension reads these comments and pre-fills the submission form:| Comment key | Description |
|---|---|
# wvsc-region: <region> | Cloud region for the job run |
# wvsc-instanceSize: <size> | Runtime size (also supports wvsc-runtime-size) |
# wvsc-timeout: <seconds> | Job timeout in seconds |
# wvsc-args: <arg1>,<arg2>,... | Comma-separated arguments passed to the script |
Cost considerations
Job runs are billed based on runtime size and duration. See Runtimes for pricing details. Confirm your Organization has sufficient Spatial Unit allocation before submitting jobs.Troubleshooting
Job submission fails
Job submission fails
- Verify your API key has permissions to submit jobs
- Check that the script path is valid and the file is accessible
- Review the VS Code Output panel for error details
- Confirm your Organization has sufficient Spatial Unit allocation
'The current file is not a Python file'
'The current file is not a Python file'
- Job submission only supports saved
.pyfiles - Save untitled files and confirm the file extension is
.pybefore runningWherobots: Submit Job
'No script path configured' warning
'No script path configured' warning
- Set
wherobotsjobsubmit.scriptPathin VS Code Settings to an explicit managed path if needed - If left empty, the extension derives a managed default path for your user

