M-GPUX — Modal GPU Orchestrator for VS Code

Provision GPU workloads, manage multi-profile Modal accounts, and track cloud billing — all without leaving your editor.

Features

• GPU Hub Wizard — Guided multi-step flow to launch Jupyter, Python scripts, web shells, or vLLM inference servers on any NVIDIA GPU
• Persistent Dev Boxes — Create, open, pause, resume, and sync Modal Sandboxes from Quick Actions
• Multi-Account Management — Add, switch, and remove Modal profiles from the sidebar
• Budget-Aware Billing — See current-cycle usage and remaining m-gpux budget/credit per account
• Session Management — Restore, discover, stop, and sync remote sessions without losing profile context
• Hardware Probing — Inspect GPU/CPU/RAM metrics on any Modal container
• Native VS Code UI — Output Channels for logs, progress notifications with cancel, clickable URL pop-ups when tunnels are ready

Requirements

You do not need to install m-gpux or modal globally. On first use the extension offers Set up CLI, creates an isolated virtual environment in VS Code's extension storage, and installs a compatible version of both tools. An existing CLI on PATH or the explicit mgpux.cliPath setting is still preferred.

Installation

# From VSIX file
code --install-extension m-gpux-3.0.0.vsix

Or in VS Code: Ctrl+Shift+P → Extensions: Install from VSIX...

After installing, run Reload Window (Ctrl+Shift+P → Reload Window).

Getting Started

1. Open the Sidebar

Click the GPU chip icon on the Activity Bar (left edge). Four panels appear:

2. Add Your First Account

Click the + button on the Accounts panel header, or run Ctrl+Shift+P → M-GPUX: Add Account.

You can add credentials in two ways:

• Paste shortcut — Paste a full modal token set --token-id ak-... --token-secret as-... --profile=myname command. The extension parses it automatically.
• Manual entry — Leave the input empty and fill in Token ID, Token Secret, and Profile Name step by step.

The first profile is automatically set as active.

3. Launch a GPU Workload

Click GPU Hub in Quick Actions, or run Ctrl+Shift+P → M-GPUX: Open GPU Hub.

The wizard walks you through four steps:

Step 1 — Select Profile

Choose a Modal account. AUTO uses the currently active profile.

Step 2 — Choose GPU

Step 3 — Choose Application

Step 4 — Configure & Launch

• For Jupyter and Python: optionally use requirements.txt and set exclude patterns for file upload.
• The extension generates a modal_runner.py script and opens it in the editor for review.
• Click Launch → the process runs in the background with a progress notification.
• When a tunnel URL is detected, a notification pops up with Open in Browser and Copy URL buttons.
• The temp script is cleaned up automatically when the process exits.

Account Management

Status Bar

The bottom-left of VS Code shows ☁ M-GPUX: <profile-name>. Click it to switch profiles.

Billing

• Sidebar — Each account shows remaining m-gpux budget when configured, otherwise remaining monthly credit.
• Billing Usage — Uses Modal's current-cycle billing API with a compatibility fallback, across profiles in parallel.
• Billing Dashboard — Opens modal.com/settings/usage in your browser.

All Commands

Open the Command Palette (Ctrl+Shift+P) and type M-GPUX:

Configuration

The extension reads and writes ~/.modal.toml directly — the same file used by the Modal CLI. mgpux.cliPath can point to an existing compatible executable; otherwise the extension uses PATH or its private managed environment.

Example ~/.modal.toml:

[personal]
token_id = "ak-xxxx"
token_secret = "as-xxxx"
active = true

[work]
token_id = "ak-yyyy"
token_secret = "as-yyyy"

Quick Workflow

1. Open VS Code with your Python project
2. Click the M-GPUX icon on the sidebar
3. Add an account if you haven't already (+ button)
4. Click "GPU Hub" → pick a GPU → pick Jupyter Lab
5. Review the generated script → click Launch
6. Notification pops up with your Jupyter URL → Open in Browser
7. Code on a remote GPU with your workspace files ready at /workspace

Troubleshooting