Skip to main content

etunnel for Python

websocket-client based.

Zero registration: every SDK client speaks the same tiny wire protocol (PROTOCOL.md) against any etunnel server (default wss://t.ggcode.uk/tunnel).

Install

pip install etunnel

Python >= 3.8 (websocket-client installed automatically).

CLI

etunnel 3000

Prints TUNNEL_URL: https://<subdomain>.t.ggcode.uk — that URL now routes to your local service. Ctrl-C closes the tunnel.

Embed

from etunnel import connect
t = connect("wss://t.ggcode.uk/tunnel", 3000, {})
print(t["url"])

Environment variables

Variable Meaning Default
ETUNNEL_SERVER tunnel server WebSocket URL wss://t.ggcode.uk/tunnel
ETUNNEL_LOCAL local port or host:port (or 1st CLI arg) 3000
ETUNNEL_TOKEN paid-plan API key (optional) -
ETUNNEL_SUBDOMAIN custom subdomain (paid plans) random

License

MIT — see LICENSE. Buffer-based protocol client: request and response bodies are buffered per stream (fine for webhooks/dashboards/demos; use the Go SDK for streaming and WebSocket pass-through).

Metadata

Release files for etunnel 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for etunnel 1.0.0
File Size Uploaded Provenance Actions
etunnel-1.0.0.tar.gz 4.3 kB With provenance Details for etunnel-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for etunnel 1.0.0
File Interpreter ABI Platform Actions
etunnel-1.0.0-py3-none-any.whl Python 3 none any Details for etunnel-1.0.0-py3-none-any.whl

Total release size: 8.9 kB

Release files / etunnel-1.0.0.tar.gz

Download URL etunnel-1.0.0.tar.gz
Size 4.3 kB
Tags Source
SHA-256 checksum
How to use checksums
f5563e3bd9886cfe938302437a2460b6208aabb389b0688347e3dd96abacfc75
BLAKE2b-256 checksum
How to use checksums
b6a68295a8fcffa684e0b38aefbbe5d571b62d424ee18f8b959920ec984154fa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Release files / etunnel-1.0.0-py3-none-any.whl

Download URL etunnel-1.0.0-py3-none-any.whl
Size 4.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0afe0dd0dd1bb1c9ca8a1ba813fdb790e90163417f2ca7c5d29c67574368c1d9
BLAKE2b-256 checksum
How to use checksums
adbf6ab456b84cba4efbdb6682b2650f3907dc434cfdedd32ec849dac48a494c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Security for etunnel 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for etunnel-1.0.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page