Skip to content

Repository files navigation

pypproxy

MITM HTTP/HTTPS proxy for inspecting, modifying, and testing traffic from browsers and mobile apps.

CIPyPIPython

pip install pypproxy
pypproxy # GUI mode → http://localhost:8081
pypproxy --mode cui # Terminal UI

See the docs for setup, CA installation, and feature guides.

Features

CategoryFeatures
ProxyHTTP/HTTPS MITM, WebSocket, gRPC, MQTT, HTTP/2
UISidebar navigation, dark/light mode, real-time traffic table
InterceptManual request review, edit headers/body, forward or drop
RulesBlock / modify / redirect by host, path, method, header, body (regex)
DecodeAuto-detect gzip/brotli, JSON, XML, JWT, Base64, multipart, Protobuf, MessagePack, CBOR
ReplayOne-click replay, parallel fuzzing, Resender tab with full editor
Bulk SenderPayload list mode + race condition test
DiffUnified diff between any two captured entries
A/B TestSend same request to two hosts, compare responses
MacroChain requests with {{variable}} substitution and response extraction
GraphQLAuto-detect, introspection, schema tree, query editor
OpenAPIAuto-generate OpenAPI 3.0 spec from captured traffic
Code GenExport as curl / Python requests / JavaScript fetch / HTTPie
AnalyticsPer-host stats, P95/P99 latency, status distribution
SecurityJWT checker, header checker, token randomness, int overflow, CORS, SSRF, redirect, IDOR
FridaSSL pinning bypass scripts, script injection, device management
SessionsGroup entries into named sessions with persistence
ReportExport HTML or Markdown report with findings
Import/ExportHAR, pypproxy JSON, OpenAPI, rules
Full-text searchSQLite FTS5 across all captured traffic
ScopeCapture only in-scope hosts
DNS spoofingBuilt-in DNS server with domain override
ScriptsPython on_request / on_response hooks
PluginsDrop .py files into ~/.pypproxy/plugins/

Quick start

# Install
pip install pypproxy
# Start (GUI mode)
pypproxy
# Install CA certificate (macOS)
sudo security add-trusted-cert -d -r trustRoot \
-k /Library/Keychains/System.keychain ~/.pypproxy/ca-cert.pem
# Set system proxy (macOS)
networksetup -setwebproxy Wi-Fi 127.0.0.1 8080
networksetup -setsecurewebproxy Wi-Fi 127.0.0.1 8080

Open http://localhost:8081 — traffic appears in real time.

Optional: Frida integration

pip install 'pypproxy[frida]'

Enables one-click SSL pinning bypass and script injection from the Frida tab.

CLI flags

--mode gui (default) or cui
--port Proxy port (default 8080)
--ui-port Web UI port (default 8081)
--config Path to YAML config file
--script Path to Python script file
--ca-dir CA cert directory (default ~/.pypproxy)
--no-db Disable SQLite persistence

License

MIT

About

MITM HTTP/HTTPS proxy for inspecting and modifying traffic — GUI/CUI, rule engine, GraphQL support, security tools

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages