Workspaces
A workspace is a persistent development environment running in the cloud. It gives you the full Neural Inverse IDE in a browser tab - VS Code interface, terminal, AI agents, and firmware tools - backed by a Kubernetes pod with dedicated CPU, RAM, and disk.
Creating a Workspace
- Go to cloud.neuralinverse.com
- Click New Workspace
- Select the
Neural Inverse O1template - Choose resources (CPU, RAM, disk)
- Click Create Workspace
The workspace starts in under 60 seconds. Click Neural Inverse Cloud to open the IDE in a new tab.
Resource Options
| Resource | Options |
|---|---|
| CPU | 2, 4, 6, or 8 cores |
| RAM | 2, 4, 6, or 8 GB |
| Disk | 1-99 GB (persistent, survives stop/start) |
Resource selection affects billing. See Billing for rates.
Workspace State
| State | Description |
|---|---|
| Starting | Pod provisioning and agent connecting |
| Running | IDE active, terminal accessible |
| Stopping | Code being committed to Base, pod terminating |
| Stopped | Pod terminated, disk persisted, code saved to Base |
Automatic Code Sync
Every workspace is linked to a private Git repository on Base. Code sync happens automatically:
- On start - workspace pulls latest code from Base before the IDE opens
- Every 5 minutes - background auto-save commits and pushes changes
- On stop - final commit pushed before the pod terminates
Your code is always saved. If the workspace crashes, the last auto-save is on Base.
The git repo is named {your-username}/{workspace-name} and is private by default.
Connecting
Browser IDE
Click Neural Inverse Cloud on the workspace page. Opens at code-server--{workspace}--{owner}.workspace.neuralinverse.com.
Browser Terminal
Click Terminal on the workspace page for a standalone terminal tab without the full IDE.
SSH
Click Connect via SSH and follow the instructions. Requires the Neural Inverse CLI configured with neuralinverse config-ssh.
Neural Inverse Desktop App
Download the Neural Inverse desktop app from github.com/NeuralInverse/neuralinverse/releases (macOS, Linux, Windows), then click Neural Inverse Desktop on the workspace page to connect via remote SSH.
VS Code Desktop
Click VS Code Desktop on the workspace page to open the workspace in your local VS Code via remote SSH.
Environment Variables
Workspace pods receive environment variables automatically:
| Variable | Value |
|---|---|
NEURALINVERSE_MODEL_URL | Free model service endpoint |
NEURALINVERSE_HARDWARE_URL | Hardware Runner endpoint |
Additional variables are injected when you connect services from their dashboards - clicking "Connect to Cloud IDE" in the model or hardware runner dashboard injects the relevant API key into all your workspaces automatically.
Stopping a Workspace
Click Stop on the workspace page. The stop script runs, commits all changes to Base, and terminates the pod. Your disk (home volume) persists and is reattached on next start.
Workspaces stop automatically when the free trial credit ($1.22) is exhausted. Paid accounts are never stopped automatically.
Deleting a Workspace
Deleting a workspace removes the pod and the persistent disk. Your code remains in Base - the git repository is not deleted.
Last edited