proxy.py

What it is and what it does

proxy.py is a full-featured HTTP proxy server framework written in Python that operates as both a forward and reverse proxy with built-in support for TLS interception, DNS-over-HTTPS, and custom request/response manipulation. It uses asyncio for threadless, event-driven concurrency and is designed to handle high connection volumes efficiently. The package is structured around a plugin architecture, allowing developers to intercept and modify HTTP traffic, implement custom routing, cache responses, perform authentication, and integrate with external services without modifying the core proxy code.

The framework is suitable for development, testing, monitoring, and production deployment scenarios. It can be run standalone from the command line, embedded directly in Python applications, deployed via Docker, or used as a library for building custom proxy solutions. The package includes utilities for HTTP request/response building, TCP socket management, and PKI operations, plus a dashboard for traffic inspection and Prometheus metrics support.

Use it for:

• Intercept and modify HTTP requests/responses during development and testing without external tools.
• Implement custom DNS resolution or traffic filtering rules via plugins for network control.
• Deploy as a lightweight reverse proxy or load balancer for small to medium workloads.
• Perform TLS interception for security research, monitoring, or compliance auditing.
• Build a drop-in ngrok alternative (GROUT) to expose local services over SSH tunnels or public URLs.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A lightweight, pluggable HTTP proxy server framework that handles forward proxying, reverse proxying, and TLS interception with support for custom plugins and asyncio-based concurrency.

Yes. The package is production-stable, actively maintained, has zero known vulnerabilities, installs with no dependencies, and offers a flexible plugin-based architecture suitable for both simple proxy use cases and complex custom implementations. The low install friction and broad platform support make it a practical choice for developers needing HTTP proxy functionality.

Install

proxy-py on PyPI

pip install proxy-py

uv add proxy-py

poetry add proxy-py

Installing proxy.py

Before you install

Low friction installation with no runtime dependencies. Actively maintained with recent commits and a stable release history spanning over a decade.

License in practice

BSD license is permissive; you can use, modify, and distribute this package with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart

pip install proxy.py

from proxy.py import Proxy

proxy = Proxy()
proxy.start()

Requires Python 3.6 or later; some features like TLS interception may require additional system configuration or certificates.

Verify before relying

• Whether the package's asyncio implementation actually achieves the benchmark throughput of 51667 requests/sec in typical production environments.
• Specific resource requirements (memory, CPU) for handling sustained high-concurrency workloads.
• Compatibility and performance implications when running on Windows vs. POSIX systems.

Package facts

Evidence: proxy.py-2.4.10-py3-none-any.whl

Keywords: http, proxy, http proxy server, proxy server, http server, http web server, proxy framework, web framework, Python3

Tags

More Python Modules packages