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.

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/trqsh/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

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.