---
id: mitmproxy
version: "12.2.3"
license: Copyright (c) 2013, Aldo Cortesi. All rights reserved. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# mitmproxy — An interactive, SSL/TLS-capable intercepting proxy for HTTP/1, HTTP/2, and WebSockets.

License: permissive · Maintenance: active · Downloads: 6.3M/mo

## What it is and what it does

mitmproxy is a mature, actively maintained intercepting proxy designed to capture, inspect, and modify HTTP/1, HTTP/2, and WebSocket traffic in real time. It provides three interfaces—an interactive console (mitmproxy), a command-line tool (mitmdump), and a web UI (mitmweb)—making it accessible for different workflows. The package handles SSL/TLS interception, allowing you to see encrypted traffic contents, and supports scripting and modification of requests and responses on the fly.

The package depends on a substantial set of runtime libraries covering cryptography (cryptography, pyOpenSSL, argon2-cffi, bcrypt), HTTP protocol support (h2, h11, hyperframe, wsproto, aioquic), data handling (msgpack, ruamel.yaml, zstandard), and UI rendering (urwid for console, flask for web). It is classified as Production/Stable and supports Python 3.12, 3.13, and 3.14, with no known security vulnerabilities as of the fact sheet date.

Use it for:

- Debug and inspect HTTP/HTTPS requests and responses from web applications during development and testing.
- Intercept and modify API traffic to test error handling, edge cases, or inject test data without changing client code.
- Monitor and analyze WebSocket traffic for real-time communication protocols in web applications.
- Perform security testing by observing encrypted TLS traffic and validating certificate handling.
- Automate traffic manipulation via scripts to simulate network conditions or third-party service responses.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

mitmproxy is an interactive, SSL/TLS-capable intercepting proxy that captures and inspects HTTP/1, HTTP/2, and WebSocket traffic with console, command-line, or web-based interfaces.

Yes. mitmproxy is a well-established, actively maintained tool with no known vulnerabilities, low install friction, and a permissive MIT license. It is suitable for developers, QA engineers, and security professionals who need to inspect or modify HTTP(S) and WebSocket traffic. Install it if you need interactive traffic inspection, debugging, or testing capabilities.

## Install

pip install mitmproxy
uv add mitmproxy
poetry add mitmproxy

## Installing mitmproxy

Before you install: Low install friction with a pure-wheel distribution. Active maintenance with a recent commit on 2026-08-13 and 44699 repository stars. Requires Python 3.12 or later.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart:

pip install mitmproxy
mitmproxy  # Start interactive proxy console
# or: mitmdump  # Command-line mode
# or: mitmweb  # Web-based interface

Requires Python 3.12 or later; system may need elevated privileges to intercept network traffic depending on OS and network configuration.

Verify before relying:

- Specific platform support details beyond the listed classifiers (macOS, Windows, POSIX).
- Whether mitmproxy-rs is a compiled extension and what its build requirements are.
- Performance characteristics or throughput limits for high-volume traffic inspection.

## Package facts

- License: Copyright (c) 2013, Aldo Cortesi. All rights reserved. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 6.3M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

http proxy interceptor, ssl tls traffic inspection, http debugging proxy, websocket proxy, network traffic capture, man-in-the-middle proxy, http request modifier, network-debugging, http-inspection, security-testing

[View on SkillFed](https://skillfed.io/packages/mitmproxy) · [View on PyPI](https://pypi.org/project/mitmproxy/)