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/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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
987965c6a1aeafda83702d349b57a8b64a067d0f114ff65fa9c9039875a9ff1a
|
|
| MD5 |
7121164f15f6e70bb0c8854d1cba47c1
|
|
| BLAKE2b-256 |
c815e2aa8ffaa1314cf1c2583294dd5e29bc29d11b0c7f57534e1572aa04242c
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
93acd8d5d5213db355966a24b178fee2212e9f55bed7836dd23b785b38bee5bd
|
|
| MD5 |
1ff40ad4438f0248bf0e0b12b05ec84c
|
|
| BLAKE2b-256 |
a9ea42b88f1b090a9fd0a6895441f066fd577cf970f5f2a2bb1fe4eb606472fa
|