Skip to main content

Run any command in the cloud. Like tmux, but virtual.

Project description

vmux

Run any command in the cloud. Like tmux, but virtual.

Install

# Install globally
uv tool install vmux-cli

# Or run without installing
uvx --from vmux-cli vmux run python train.py

Usage

# Login with GitHub
vmux login

# Run a command (streams output)
vmux run python train.py

# Run in background
vmux run --detach python long_job.py

# Run a web server with preview URL
vmux run --preview uvicorn main:app
# → Preview: https://abc123.purr.ge

# Attach to running job
vmux attach <job_id>

# View logs
vmux logs <job_id>

# List jobs
vmux ps

Features

  • Cloud execution: Run Python scripts on Cloudflare containers
  • Automatic dependencies: Uses uv for instant package installs
  • Interactive terminal: Attach to running jobs via tmux
  • Background jobs: Detach and reattach anytime
  • Preview URLs: Share web apps instantly with --preview (port 8000)

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vmux_cli-0.4.0.tar.gz (60.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vmux_cli-0.4.0-py3-none-any.whl (24.4 kB view details)

Uploaded Python 3

File details

Details for the file vmux_cli-0.4.0.tar.gz.

File metadata

  • Download URL: vmux_cli-0.4.0.tar.gz
  • Upload date:
  • Size: 60.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.8

File hashes

Hashes for vmux_cli-0.4.0.tar.gz
Algorithm Hash digest
SHA256 b7f06a01a8b2a770d50cd7927cba8c97350f0b98d37371bbc6c53856be456e6c
MD5 9feb6e73d135f1b2da2d5a6150671d4a
BLAKE2b-256 ccf464530e0fbe93cba6bb5a597cd4428a76eebfe42543792eab854ede510ea8

See more details on using hashes here.

File details

Details for the file vmux_cli-0.4.0-py3-none-any.whl.

File metadata

  • Download URL: vmux_cli-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 24.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.8

File hashes

Hashes for vmux_cli-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 034f54a7cea307406ae270a839124661f84f89fb033a2b4af070d29b7b7c565a
MD5 3f2c1501c765805fe96d5c39a45e14c6
BLAKE2b-256 ab2f09732791a304c7c30ded7cecbf61a49c7154b7f544f984f68d37e4a62f12

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page