impersonate-proxy

HTTP/HTTPS proxy that impersonates browser TLS fingerprints using curl_cffi that can be effective in avoiding blocks against non-browser clients.

Design Philosophy

impersonate-proxy does not attempt to manually re-implement browser headers or replicate curl-impersonate in Python. Instead, it acts as a lightweight adapter:

• Strips conflicting non-browser client headers (e.g. User-Agent: python-httpx) so native curl-impersonate defaults shine through.
• Preserves request payload, auth, and shape semantics (Cookie, Authorization, Host, Sec-Fetch-* for XHR).
• Delegates all browser TLS fingerprinting and header generation directly to curl-impersonate via curl_cffi.
• Overrides curl_cffi's residual tells with a curated, platform-coherent fingerprint — full-build User-Agent, complete Sec-CH-UA family, and canonical HTTP/2 header order for Chrome targets, UA-only for Firefox targets — enabled by default (--no-fingerprint-real to disable).

Pypi: pypi.org/project/impersonate-proxy

GHCR: github.com/psaintelligence/impersonate-proxy/pkgs/container

Quick Start (Docker)

Spin up the proxy container:

docker run --rm -p 8899:8899 \
  -v /tmp/impersonate-certs:/home/impersonate/.config/impersonate-proxy \
  ghcr.io/psaintelligence/impersonate-proxy:latest

Once started, configure your client to trust the CA and use the proxy:

# Export the generated CA cert to trust the proxy
export SSL_CERT_FILE=/tmp/impersonate-certs/ca.crt

# Issue request through the proxy
curl --silent -x http://127.0.0.1:8899 https://tls.browserleaks.com/json

Quick Start (pip / uv)

Install and start the proxy locally:

# Install via pipx from pypi
pipx install impersonate-proxy

# Or install via uv from source
uv pip install git+https://github.com/psaintelligence/impersonate-proxy.git

# Start the proxy (default: 127.0.0.1:8899)
impersonate-proxy

Documentation

Full guides and configuration details are available at psaintelligence.github.io/impersonate-proxy.

• Installation Guide: Setup, CLI arguments, and Docker.
• How It Works: Detailed information about TLS impersonation and HTTPS decryption.
• Development Guide: Building, running benchmarks, and tests.