m-gpux
The GPU workbench for Modal.
m-gpux is a CLI for getting real work done on Modal GPUs. It turns a folder on your laptop into a GPU dev box, a Jupyter session, a hosted web app, an OpenAI-compatible LLM endpoint, or a whole Docker Compose stack — across every Modal account you own, with the price per hour in front of you before anything starts.
Quickstart
pip install m-gpux # also installs the `modal` CLI that m-gpux drives
m-gpux account add # paste a `modal token set ...` command
cd my-project
m-gpux dev up # pick an account and a GPU; this folder lands in /workspace
m-gpux dev code # open it in VS Code (Remote-SSH)
m-gpux dev pause # snapshot everything, stop paying for compute
If you'd rather click through a menu, m-gpux hub launches Jupyter, a script run, a browser terminal, or vLLM on any GPU from one guided wizard.
For the same workflows inside your editor, install the m-gpux VS Code extension.
m-gpux ecosystem
The CLI works on its own, and each piece below plugs into the same accounts, presets, and budgets.
- CLI — dev boxes, Hub, hosting, serving, Compose, budgets, and billing from one command
- VS Code extension — accounts, sessions, presets, and the Hub / host / serve wizards in a sidebar
- Documentation — guides for every workflow, plus the full command reference
- Examples — ready-to-deploy FastAPI, Flask, and static-site projects for
m-gpux host
Why use m-gpux?
m-gpux wraps Modal's primitives (Sandboxes, Functions, Servers, Volumes, named Images) into workflows that fit how you already develop.
- Dev boxes that survive the night — Sandboxes running
sshd, reachable with plainsshor VS Code Remote-SSH.pausesnapshots the whole filesystem andresumeboots it back in seconds;sync push/pullmoves files both ways - Every GPU, priced up front — T4 through H100, H200, B200, and B300, including multi-GPU containers (
H100:8), with $/hour in every picker andm-gpux billing ratesfor the live price table - Many accounts, one budget — per-account monthly limits, budget-aware AUTO selection, a warning before you launch on an account that's nearly empty, and
budget check --stopto shut down apps on accounts that go over - From localhost to a URL —
m-gpux hostdeploys FastAPI, Flask, Django, or a static folder with scale-to-zero;--serveruses Modal's low-latency@app.server()primitive - Your own OpenAI-compatible endpoint —
m-gpux serve deployputs any Hugging Face model behind vLLM with API keys, streaming, warmup, logs, and a live metrics dashboard - Docker Compose, lifted as-is — run a
docker-compose.ymlas one container, a full VM-style image (Triton, gRPC), or one Sandbox per service with readiness probes and working service-to-service addresses - Starts in seconds, not minutes —
m-gpux image buildbakes your dependencies once and publishes them to every account; Hub and dev boxes offer them as the base image - Nothing hidden — every workflow generates a plain Modal script you can read and edit before it runs
Resources
- Documentation — getting started, guides, and FAQ
- Command reference — every command and option
- Dev boxes — SSH, VS Code, pause/resume, and sync in depth
- Costs, budgets & images — GPU catalog, prices, budgets, and published images
- Docker Compose guide — subprocess, VM, and sandbox modes
- Architecture — plugins, the generated-script pattern, and how third-party plugins add commands
- Issues — bug reports and feature requests
Contributing
git clone https://github.com/PuxHocDL/m-gpux.git
cd m-gpux
pip install -e ".[dev,docs]"
m-gpux --help
Each command group is a plugin in m_gpux/plugins/<name>/plugin.py, registered in both m_gpux/plugins/__init__.py and the m_gpux.plugins entry-point group in pyproject.toml.
Run the same checks used by CI before opening a pull request:
ruff check m_gpux tests
python -m unittest discover -s tests -v
mkdocs build --strict
cd m-gpux-vscode
npm ci
npm run typecheck
npm run compile
cd ../m-gpux-ui
npm ci
npm run build
License
1 maintainer
Metadata
1 maintainer
Release files for m-gpux 3.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| m_gpux-3.0.0.tar.gz | 134.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| m_gpux-3.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 281.3 kB
Release files / m_gpux-3.0.0.tar.gz
| Download URL | m_gpux-3.0.0.tar.gz |
|---|---|
| Size | 134.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
076c525116e2872f8c129985fade80f02a90ff0616865e204e1319aea0c0edb5
|
|
BLAKE2b-256 checksum How to use checksums |
c238648ed8b7d70ca74c83adfa62e064a9b0cc317d2505ec1f4c13203f044d98
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 20, 2026.
Transparency logRelease files / m_gpux-3.0.0-py3-none-any.whl
| Download URL | m_gpux-3.0.0-py3-none-any.whl |
|---|---|
| Size | 147.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c3770314827501d3a1f30e398411b7f45e2a35a03c82b1e9f1b7a0dcf75a25a7
|
|
BLAKE2b-256 checksum How to use checksums |
b67cd0260fb01fb4fd44cbbd2965fc4ad995b435368766d2863615844de4f4fa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 20, 2026.
Transparency log
