Skip to main content

MaskTunnel Python Bindings

PyPI version

Python bindings for MaskTunnel — an HTTP(S) MITM proxy that adapts its browser fingerprint based on the request User-Agent.

This package wraps the Go implementation and exposes a Python-friendly API.

Overview

MaskTunnel is an HTTP proxy that dynamically changes its fingerprint to mimic real browsers (Chrome / Firefox / Safari / Edge) according to the User-Agent header in requests.

Key capabilities:

  • Browser-like TLS fingerprints (JA3 / JA4)
  • Browser-like HTTP/2 fingerprints (e.g. Akamai-style settings and frame patterns)
  • Automatic selection based on User-Agent
  • Optional response JavaScript injection
  • Optional upstream proxy chaining

Installation

pip install masktunnel

Build from source (sdist)

Building from source requires:

  • Python 3.9+
  • Go toolchain
  • A C toolchain suitable for building Python extensions

Quick Start

Run a proxy server

from masktunnel import Server

server = Server()
print(f"Proxy running at: {server.addr}")

# Blocking; run in a thread if needed
server.start()

Use CLI

After installation:

masktunnel server --port 8080

API

Server

Create a server with options:

from masktunnel import Server, ServerOptions

opts = ServerOptions(
	port="8080",
	username="",
	password="",
	payload="",
	upstream_proxy="",
	user_agent="",
	verbose=0,
)

server = Server(options=opts)

Common operations:

server.start()
server.stop()
server.reset_sessions()

Notes

  • The native module is generated at build time into masktunnellib/.
  • Prefer installing wheels when available; building from source depends on the local toolchain.

Metadata

Release files for masktunnel 1.1.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for masktunnel 1.1.6
File Size Uploaded Provenance Actions
masktunnel-1.1.6.tar.gz 23.8 kB With provenance Details for masktunnel-1.1.6.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for masktunnel 1.1.6
File Actions
masktunnel-1.1.6-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for masktunnel-1.1.6-py3-none-win_amd64.whl
masktunnel-1.1.6-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for masktunnel-1.1.6-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
masktunnel-1.1.6-py3-none-manylinux1_x86_64.manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_5_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64, Linux glibc 2.5+ x86-64 Details for masktunnel-1.1.6-py3-none-manylinux1_x86_64.manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_5_x86_64.whl
masktunnel-1.1.6-py3-none-macosx_15_0_x86_64.whl Python 3 none macOS 15.0+ x86-64 Details for masktunnel-1.1.6-py3-none-macosx_15_0_x86_64.whl
masktunnel-1.1.6-py3-none-macosx_15_0_arm64.whl Python 3 none macOS 15.0+ ARM64 Details for masktunnel-1.1.6-py3-none-macosx_15_0_arm64.whl

Total release size: 45.8 MB

Release files / masktunnel-1.1.6.tar.gz

Download URL masktunnel-1.1.6.tar.gz
Size 23.8 kB
Tags Source
SHA-256 checksum
How to use checksums
a23aa4b346e4eec4b47ef2d589d083e57cc275e43fbfcbcaa536430e24f6e5d2
BLAKE2b-256 checksum
How to use checksums
b32d92fed1e43dcfe97dd8eca82f2d49d839b3dc5e5b9a280598eac12303e95a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / masktunnel-1.1.6-py3-none-win_amd64.whl

Download URL masktunnel-1.1.6-py3-none-win_amd64.whl
Size 11.3 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
e77d9c903d475edad993eba5a6e570abaf9900bc7e422966d1c2e0a0cbe553af
BLAKE2b-256 checksum
How to use checksums
58ee44240941399040e14f116b0802e411c6f5b0a579b80a6624548541b040c8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / masktunnel-1.1.6-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL masktunnel-1.1.6-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 10.7 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
d2b96988690f583722b3df8288be6a43c026086e7faeaa5b6d3964ff0eeb5801
BLAKE2b-256 checksum
How to use checksums
b9130a1197c116b4c0d9991051190deb4b18fa05a9a5c3f08ffbc59b556844fb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / masktunnel-1.1.6-py3-none-manylinux1_x86_64.manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_5_x86_64.whl

Download URL masktunnel-1.1.6-py3-none-manylinux1_x86_64.manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_5_x86_64.whl
Size 11.5 MB
Tags Linux glibc 2.17+ x86-64 Linux glibc 2.5+ x86-64 Python 3
SHA-256 checksum
How to use checksums
49892387594922ff049db934a54f23487af1d529ba86c0ca64655b4637e892e9
BLAKE2b-256 checksum
How to use checksums
9323b0140abeaf49ebc6fc13c970650e0e015fccb6112d0aba3f7f32913229ee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / masktunnel-1.1.6-py3-none-macosx_15_0_x86_64.whl

Download URL masktunnel-1.1.6-py3-none-macosx_15_0_x86_64.whl
Size 6.3 MB
Tags Python 3 macOS 15.0+ x86-64
SHA-256 checksum
How to use checksums
f4933d740e37ab30e75894a8f07192f2ea780effbf14965005f3b047b803e63e
BLAKE2b-256 checksum
How to use checksums
e66e81463edadedd683ccf03b907a98692b1f77f86cdcf3778402f1b42ded8a7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / masktunnel-1.1.6-py3-none-macosx_15_0_arm64.whl

Download URL masktunnel-1.1.6-py3-none-macosx_15_0_arm64.whl
Size 5.9 MB
Tags Python 3 macOS 15.0+ ARM64
SHA-256 checksum
How to use checksums
9d97e81a165c7a278675e3b5c46fe69d54d16a84ab7cfc4bb3a4fa5e1ca75844
BLAKE2b-256 checksum
How to use checksums
07cc8b3a0a7189483cf1eb4338f46ef6a4e6404dbee750d8e407381883aa92e4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Security for masktunnel 1.1.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 6 files in this release have been uploaded with provenance metadata.

Select from 6 files

Attestation for masktunnel-1.1.6.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page