Skip to main content
The Wherobots VS Code extension brings job submission directly into your editor. Submit the current .py file to Wherobots Cloud from the Command Palette with configurable runtime, region, timeout, and arguments. Monitor progress and review results alongside your code.
  1. Open a saved .py file in VS Code.
  2. Open the Command Palette ( + + P) and run Wherobots: Submit Job.
  3. Confirm runtime, region, and timeout in the submission form, then submit.
  4. Click Open Job in the success notification to track the run in the Wherobots Cloud Console.

Before you start

Ensure you have the following:

Submit a job

1
Open a saved Python file (.py) in VS Code.
2
Open the Command Palette ( + + P on Mac, Ctrl + Shift + P on Windows/Linux).
3
Type Wherobots and select Wherobots: Submit Job.
4
Confirm job options in the submission form — including runtime size, region, arguments, and timeout.
5
Submit the job. Use the Open Job action from the success notification to track the job in the Wherobots Cloud Console.
Job runs execute on Wherobots Cloud infrastructure and appear in Workload History. For more information on job runs, see Job Runs REST API.

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:
# wvsc-region: aws-us-west-2
# wvsc-instanceSize: medium
# wvsc-timeout: 7200
# wvsc-args: input.csv,output.csv
Supported keys:
Comment keyDescription
# 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

  • 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
  • Job submission only supports saved .py files
  • Save untitled files and confirm the file extension is .py before running Wherobots: Submit Job
  • Set wherobotsjobsubmit.scriptPath in VS Code Settings to an explicit managed path if needed
  • If left empty, the extension derives a managed default path for your user