# abhinavsingh/proxy.py

💫 Ngrok FRP Alternative • ⚡ Fast • 🪶 Lightweight • 0️⃣ Dependency • 🔌 Pluggable • 😈 TLS interception • 🔒 DNS-over-HTTPS • 🔥 Poor Man's VPN • ⏪ Reverse & ⏩ Forward • 👮🏿 "Proxy Server" framework • 🌐 "Web Server" framework • ➵ ➶ ➷ ➠ "PubSub" framework • 👷 "Work" acceptor & executor framework

Repository: https://github.com/abhinavsingh/proxy.py
Canonical: https://ross.abutalabs.com/products/proxypy
Homepage: https://abhinavsingh.com/proxy-py-a-lightweight-single-file-http-proxy-server-in-python/
Language: Python
License: BSD-3-Clause
License Family: permissive
Topics: http-proxy, python3, webserver, proxy, https-proxy, mitmproxy, man-in-the-middle, http-server, tls-interception, proxy-server, dns-over-https, reverse-proxy, gfw, vpn, mitm, tunnel, web-server, ngrok, ngrok-alternative, ngrok-replacement
Last push: 2026-08-17T22:02:23+00:00

## Health v2 (maintenance only)
Score: 74/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 28, longevity 100
- inputs: {"age_days": 4762, "days_push": 16, "days_rel": 561, "gap_med": 74.0, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3550, forks 626 (observed 2026-08-28T04:08:09.511735+00:00)

## What it is
proxy.py is a fast, lightweight, zero-dependency Python library and CLI tool for building HTTP/HTTPS proxy servers and web servers, with pluggable frameworks for TLS interception, DNS-over-HTTPS, reverse/forward proxying, PubSub, and work execution. It can serve as an ngrok/FRP alternative or a 'poor man's VPN' for tunneling and traffic interception scenarios.

## Use cases
- run a local http/https proxy server in python
- intercept tls traffic for debugging
- expose a local server to the internet like ngrok
- set up a reverse proxy
- build a custom proxy with plugins
- test apps behind a man-in-the-middle proxy
- tunnel traffic as a lightweight vpn alternative

## When to choose
- you need a zero-dependency, embeddable proxy in Python
- you want a programmable proxy framework with plugin support
- you need TLS interception or MITM capabilities for testing
- you want a lightweight ngrok alternative you control

## When to avoid
- you need production-grade high-throughput proxying like nginx or HAProxy
- you need a full-featured VPN with strong encryption guarantees
- you need a GUI-based proxy tool like Charles or Fiddler

## Facets
- artifact type: library
- maturity: active
- function: proxy, http-server, web-framework, middleware, security, networking
- domain: networking, security, developer-tools, web-development, privacy
- platform: python, windows, cross-platform, cli
- tags: http-proxy, https-proxy, tls-interception, mitm, reverse-proxy, forward-proxy, dns-over-https, tunnel, ngrok-alternative, zero-dependency, pluggable, pubsub, vpn, linux, macos, docker

## Member repositories
- abhinavsingh/proxy.py (main) score 74

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:09.511735+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-29T18:34:20.998763+00:00, confidence not recorded.
  - readme: https://github.com/abhinavsingh/proxy.py (fetched 2026-08-28T04:08:09.511735+00:00, sha 4472224e19f0)
  - registry_pypi: https://pypi.org/pypi/proxy.py/json (fetched 2026-08-29T09:28:22.402480+00:00, sha 1debf3572b5b)
- Data as of 2026-08-30T08:39:29.467469+00:00.