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.8.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.8-py3-none-any.whl (6.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: trqsh-0.1.8.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.8.tar.gz
Algorithm Hash digest
SHA256 987965c6a1aeafda83702d349b57a8b64a067d0f114ff65fa9c9039875a9ff1a
MD5 7121164f15f6e70bb0c8854d1cba47c1
BLAKE2b-256 c815e2aa8ffaa1314cf1c2583294dd5e29bc29d11b0c7f57534e1572aa04242c

See more details on using hashes here.

File details

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

File metadata

  • Download URL: trqsh-0.1.8-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.8-py3-none-any.whl
Algorithm Hash digest
SHA256 93acd8d5d5213db355966a24b178fee2212e9f55bed7836dd23b785b38bee5bd
MD5 1ff40ad4438f0248bf0e0b12b05ec84c
BLAKE2b-256 a9ea42b88f1b090a9fd0a6895441f066fd577cf970f5f2a2bb1fe4eb606472fa

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