An interactive, SSL/TLS-capable intercepting proxy for HTTP/1, HTTP/2, and WebSockets.
Project Links
Meta
Author: Aldo Cortesi
Maintainer: Maximilian Hils
Requires Python: >=3.12
Classifiers
License
- OSI Approved :: MIT License
Development Status
- 5 - Production/Stable
Environment
- Console :: Curses
Operating System
- MacOS
- POSIX
- Microsoft :: Windows
Programming Language
- Python :: 3 :: Only
- Python :: 3.12
- Python :: 3.13
- Python :: 3.14
- Python :: Implementation :: CPython
Topic
- Security
- Internet :: WWW/HTTP
- Internet :: Proxy Servers
- System :: Networking :: Monitoring
- Software Development :: Testing
Typing
- Typed
mitmproxy
mitmproxy is an interactive, SSL/TLS-capable intercepting proxy with a console
interface for HTTP/1, HTTP/2, and WebSockets.
mitmdump is the command-line version of mitmproxy. Think tcpdump for HTTP.
mitmweb is a web-based interface for mitmproxy.
Installation
The installation instructions are here. If you want to install from source, see CONTRIBUTING.md.
Documentation & Help
General information, tutorials, and precompiled binaries can be found on the mitmproxy website.
The documentation for mitmproxy is available on our website:
If you have questions on how to use mitmproxy, please use GitHub Discussions!
Contributing
As an open source project, mitmproxy welcomes contributions of all forms.
12.2.1
Nov 24, 2025
12.2.0
Oct 15, 2025
12.1.2
Aug 24, 2025
12.1.1
May 25, 2025
12.1.0
May 24, 2025
12.0.1
May 06, 2025
12.0.0
Apr 29, 2025
11.1.3
Feb 17, 2025
11.1.2
Feb 06, 2025
11.1.0
Jan 12, 2025
11.0.2
Dec 05, 2024
11.0.1
Nov 24, 2024
11.0.0
Oct 02, 2024
10.4.2
Aug 02, 2024
10.4.1
Jul 29, 2024
10.4.0
Jul 25, 2024
10.3.1
Jun 12, 2024
10.3.0
Apr 17, 2024
10.2.4
Mar 07, 2024
10.2.3
Mar 06, 2024
10.2.2
Jan 21, 2024
10.2.1
Jan 06, 2024
10.2.0
Jan 04, 2024
10.1.6
Dec 14, 2023
10.1.5
Nov 14, 2023
10.1.4
Nov 13, 2023
10.1.3
Nov 04, 2023
10.1.2
Nov 03, 2023
10.1.1
Sep 27, 2023
10.1.0
Sep 24, 2023
10.0.0
Aug 04, 2023
9.0.1
Nov 02, 2022
9.0.0
Oct 28, 2022
8.1.1
Jun 28, 2022
8.1.0
May 15, 2022
8.0.0
Mar 19, 2022
7.0.4
Sep 28, 2021
7.0.3
Sep 16, 2021
7.0.2
Aug 04, 2021
7.0.1
Aug 03, 2021
7.0.0
Jul 16, 2021
6.0.2
Dec 15, 2020
6.0.1
Dec 13, 2020
6.0.0
Dec 12, 2020
5.3.0
Nov 01, 2020
5.2
Jul 18, 2020
5.1.1
Apr 13, 2020
5.1.0
Apr 13, 2020
5.0.1
Dec 27, 2019
5.0.0
Dec 16, 2019
4.0.4
Jul 31, 2018
4.0.3
Jun 16, 2018
4.0.1
May 17, 2018
4.0.0
May 17, 2018
3.0.4
Apr 05, 2018
3.0.3
Feb 25, 2018
3.0.2
Feb 23, 2018
3.0.1
Feb 23, 2018
3.0.0
Feb 22, 2018
2.0.2
Apr 28, 2017
2.0.1
Mar 15, 2017
2.0.0
Feb 21, 2017
1.0.2
Jan 07, 2017
1.0.1
Dec 27, 2016
1.0.0
Dec 26, 2016
0.18.3
Dec 27, 2016
0.18.2
Oct 26, 2016
0.18.1
Oct 16, 2016
0.17
Apr 10, 2016
0.16
Feb 14, 2016
0.15
Dec 03, 2015
0.14.0
Nov 06, 2015
0.13
Jul 21, 2015
0.12.1
Jun 03, 2015
0.12.0
May 25, 2015
0.11.3
Dec 29, 2014
0.11.2
Dec 28, 2014
0.11.1
Nov 15, 2014
0.11
Nov 11, 2014
0.10.1
Feb 26, 2014
0.10
Jan 28, 2014
0.9.2
Aug 24, 2013
0.9.1
Jun 16, 2013
0.9
May 14, 2013
0.8.1
Nov 17, 2012
0.8
Apr 09, 2012
Wheel compatibility matrix
Files in release
Extras:
None
Dependencies:
aioquic
(<=1.2.0,>=1.2.0)
argon2-cffi
(<=25.1.0,>=23.1.0)
asgiref
(<=3.10.0,>=3.2.10)
bcrypt
(<=5.0.0,>=5.0.0)
Brotli
(<=1.2.0,>=1.0)
certifi
(>=2019.9.11)
cryptography
(<=46.1,>=42.0)
flask
(<=3.1.2,>=3.0)
h11
(<=0.16.0,>=0.16.0)
h2
(<=4.3.0,>=4.3.0)
hyperframe
(<=6.1.0,>=6.0)
kaitaistruct
(<=0.11,>=0.10)
ldap3
(<=2.9.1,>=2.8)
mitmproxy-rs
(<0.13,>=0.12.6)
msgpack
(<=1.1.2,>=1.0.0)
pyOpenSSL
(<=25.3.0,>=24.3)
pyparsing
(<=3.2.5,>=2.4.2)
pyperclip
(<=1.11.0,>=1.9.0)
ruamel.yaml
(<=0.18.16,>=0.18.10)
sortedcontainers
(<=2.4.0,>=2.3)
tornado
(<=6.5.2,>=6.5.0)
urwid
(<=3.0.3,>=2.6.14)
wsproto
(<=1.2.0,>=1.0)
publicsuffix2
(<=2.20191221,>=2.20190812)
zstandard
(<=0.25.0,>=0.25)
typing-extensions
(<=4.14,>=4.13.2)
pydivert
(<=2.1.0,>=2.0.3)