Skip to main content

trqsh

Expose localhost to the internet over fast, QUIC-first tunnels — HTTP, TCP, and UDP, with reserved subdomains, custom domains, and a live request inspector. This package installs the signed trqsh CLI binary for your platform: a thin wrapper around a small Go binary, downloaded from GitHub on first run and verified against SHA-256 checksums.

PyPI Python License

pip install trqsh
# or, isolated:
pipx install trqsh

trqsh login        # sign in through your browser
trqsh http 3000    # → a public HTTPS URL for localhost:3000

Why trqsh

  • QUIC-first, TCP fallback — lower latency on lossy/mobile networks, with automatic fallback where UDP is blocked.
  • Every protocol, including UDP — HTTP, HTTPS, TLS, TCP, and UDP tunnels.
  • Background tunnels (-d) that keep running after your terminal closes.
  • Reserved subdomains and custom domains, plus a live request inspector.
  • Fully open source (Apache-2.0) — audit it, self-host the whole stack.

Commands

trqsh login                 # sign in through your browser (GitHub/Google)
trqsh whoami                # show your account, plan and usage
trqsh http 3000             # expose localhost:3000 over a public HTTPS URL
trqsh http 3000 -d          # …in the background; returns immediately
trqsh ls                    # list running background tunnels
trqsh open <id|name>        # open a tunnel's public URL in your browser
trqsh stop <id|all>         # stop one tunnel (or all of them)
trqsh down                  # stop the background daemon entirely
trqsh subdomains            # list reserved subdomains
trqsh domains               # list your custom domains

Also trqsh tcp <port> and trqsh udp <port> for raw TCP/UDP tunnels. Run trqsh --help for the full list.

How it works

The console script trqsh calls trqsh.ensure_binary(), which detects your OS (darwin/linux/windows) and CPU (amd64/arm64), downloads trqsh_<version>_<os>_<arch>.<ext> from https://github.com/uzcreator/trqshcli/releases, verifies its SHA-256 against checksums.txt, caches the binary under ~/.cache/trqsh/<version>/, and execs it. Pure standard library — no runtime dependencies.

Environment overrides

Variable Purpose
TRQSH_VERSION Pin a specific release (defaults to the package version).
TRQSH_REPO Alternate owner/repo for the release download.
TRQSH_DOWNLOAD_BASE Full base URL of a mirror serving the release assets (for air-gapped/internal mirrors).
TRQSH_SKIP_CHECKSUM=1 Skip SHA-256 verification (not recommended).

Uninstall

trqsh uninstall        # remove local data (config, key, cache) + stop tunnels
pip uninstall trqsh    # then remove the package itself

Run trqsh uninstall first: pip uninstall drops the package but leaves your saved key, control token, logs, and the cached binary under ~/.cache/trqsh/ behind — trqsh uninstall clears those and stops any background daemon. Add -y to skip the confirmation.

Author

trqsh is created and maintained by Otabek Hamroqulov — GitHub @Hamroqulovv. Licensed Apache-2.0.

Download files

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

Source Distribution

trqsh-0.1.7.tar.gz (5.5 kB view details)

Uploaded Source

Built Distribution

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

trqsh-0.1.7-py3-none-any.whl (6.1 kB view details)

Uploaded Python 3

File details

Details for the file trqsh-0.1.7.tar.gz.

File metadata

  • Download URL: trqsh-0.1.7.tar.gz
  • Upload date:
  • Size: 5.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.13

File hashes

Hashes for trqsh-0.1.7.tar.gz
Algorithm Hash digest
SHA256 e0a44d85ed60b021b8face5214d59ac0f48671dcadfa851c66b1dddca7f7153f
MD5 2cb3f276ad0efd3ee65a609f740bdc43
BLAKE2b-256 8a756a7b39ef699c19844bbe7395836f4f22441acaa40e8b853c290728a8ee7f

See more details on using hashes here.

File details

Details for the file trqsh-0.1.7-py3-none-any.whl.

File metadata

  • Download URL: trqsh-0.1.7-py3-none-any.whl
  • Upload date:
  • Size: 6.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.13

File hashes

Hashes for trqsh-0.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 316a0110181fcd73fa09a15a3bcd329ab6ec1538f9dabd2f5a34371fe2c79551
MD5 dc75d2f9a2b50d8b9694b64a64c8272e
BLAKE2b-256 5075b7736da21a55329685571a7355dd13f06039bb583905433cccf02b9868a4

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