# byJoey/ech-wk

Repository: https://github.com/byJoey/ech-wk
Canonical: https://ross.abutalabs.com/products/ech-wk
Language: Python
License Family: other
Last push: 2025-12-19T09:00:15+00:00

## Health v2 (maintenance only)
Score: 51/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 58, release rhythm 60, longevity 19
- inputs: {"age_days": 270, "days_push": 257, "days_rel": 266, "gap_med": 0.0, "n_releases_24m": 5}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1905, forks 927 (observed 2026-08-28T04:05:51.935152+00:00)

## What it is
A cross-platform proxy client that uses TLS 1.3 Encrypted Client Hello (ECH) to encrypt SNI information, exposing both a SOCKS5 and HTTP CONNECT local proxy. It ships with a GUI and CLI, supports smart traffic routing (global, bypass China, direct), and runs on Windows, macOS, Linux, soft routers, and Docker.

## Use cases
- bypass SNI-based censorship with ECH
- run a local socks5/http proxy client
- route only China-bound traffic outside the proxy
- set up a proxy on a soft router
- hide the domains I visit from my ISP

## When to choose
- you need ECH-based SNI encryption with a simple GUI or CLI client
- you want split tunneling with China IP lists on Windows/macOS/Linux or a router
- you need both SOCKS5 and HTTP CONNECT from one local proxy

## When to avoid
- you need a full VPN with WireGuard/OpenVPN-level tunneling
- your target servers or networks do not support ECH
- you need a proxy server rather than a client

## Facets
- artifact type: application
- maturity: active
- function: proxy, vpn, networking, cli, gui, privacy
- domain: privacy, censorship-circumvention, networking, cross-platform
- platform: windows, cli
- tags: ech, encrypted-client-hello, tls-1.3, socks5, http-proxy, traffic-splitting, system-proxy, soft-router, doh, ipv6, macos, linux, desktop, docker

## Member repositories
- byJoey/ech-wk (main) score 51

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:51.935152+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:11:42.923663+00:00, confidence not recorded.
  - readme: https://github.com/byJoey/ech-wk (fetched 2026-08-28T04:05:51.935152+00:00, sha da32cc1f02b0)
- Data as of 2026-08-30T08:39:29.467469+00:00.