proxy.py is a lightweight HTTP proxy server framework written in Python that operates with zero external dependencies.
The tool addresses the need for a flexible, embeddable proxy solution by providing a pluggable architecture that supports multiple protocols and use cases. It works by implementing core proxy functionality—including forward proxying, reverse proxying, and TLS interception—within a single framework that developers can extend through plugins. The README positions it as an alternative to commercial tunnel services, emphasizing its ability to function as a poor man's VPN while remaining lightweight enough to embed in other applications.
Developers should choose this tool if they need a proxy server they can customize and control directly rather than relying on external services. It suits projects requiring DNS-over-HTTPS support, man-in-the-middle capabilities for testing, or scenarios where a lightweight reverse proxy is needed without pulling in heavy dependencies. The tool also functions as a web server framework and includes pub-sub and work acceptor-executor frameworks for building more complex networking applications. Teams evaluating alternatives should note that the README explicitly positions proxy.py against Ngrok and similar tunnel services, offering local control and zero-dependency operation as distinguishing factors.
The project shows consistent maintenance with regular updates addressing bug fixes and feature additions. Development activity demonstrates responsiveness to reported issues with timely resolutions. The codebase receives ongoing refinement with commits focused on stability and usability improvements. Community engagement appears active through issue discussions and pull request handling.
