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.5

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.5
File Size Uploaded Provenance Actions
masktunnel-1.1.5.tar.gz 23.1 kB With provenance Details for masktunnel-1.1.5.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for masktunnel 1.1.5
File Interpreter ABI Platform Actions
masktunnel-1.1.5-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for masktunnel-1.1.5-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
masktunnel-1.1.5-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.5+ x86-64, Linux glibc 2.17+ x86-64 Details for masktunnel-1.1.5-py3-none-manylinux1_x86_64.manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_5_x86_64.whl
masktunnel-1.1.5-py3-none-any.whl Python 3 none any Details for masktunnel-1.1.5-py3-none-any.whl

Total release size: 28.2 MB

Release files / masktunnel-1.1.5.tar.gz

Download URL masktunnel-1.1.5.tar.gz
Size 23.1 kB
Tags Source
SHA-256 checksum
How to use checksums
b34049d5d1bf95217d5838e8ee2f34dda5ca71e9634a84ab1ca27db9b9b6ef9d
BLAKE2b-256 checksum
How to use checksums
6f078a22ce2f98bac88503010b9ad72bff3d3a6e71e0d606488561e5db4d9f0f
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 13, 2026.

Transparency log

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

Download URL masktunnel-1.1.5-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
88c71647eedbedb900dcac47248395e746bdf7f1f94c6dc179ea374eb87af213
BLAKE2b-256 checksum
How to use checksums
4bde29bb0d33ec2ba8a9f7ae27210badfc0e274b8b3318529edcfa09fa82b029
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 13, 2026.

Transparency log

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

Download URL masktunnel-1.1.5-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
9ba3cac290633587ddb16df0a3a72d3ff07786808d7ba8ab26abbcfd9c8f5fbd
BLAKE2b-256 checksum
How to use checksums
82a60eef5c241d812150285e9c84d7ba5c894bb9d4a4ecb9e4ad9cd68a5ea315
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 13, 2026.

Transparency log

Release files / masktunnel-1.1.5-py3-none-any.whl

Download URL masktunnel-1.1.5-py3-none-any.whl
Size 5.9 MB
Tags Python 3
SHA-256 checksum
How to use checksums
371ebd41d3953c977a7e90e0e290e19a892e875a8424c9678936b4a4be22d976
BLAKE2b-256 checksum
How to use checksums
603bb48b09b49c07c66eadbd4ba4d23495f27c27aad898d550c320a16f2eefd1
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 13, 2026.

Transparency log

Security for masktunnel 1.1.5

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 4 files in this release have been uploaded with provenance metadata.

Select from 4 files

Attestation for masktunnel-1.1.5.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 13, 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