Project Links

Meta

Author: deedy5

Requires Python: >=3.10

Classifiers

Programming Language

Rust
Python :: 3
Python :: 3 :: Only
Python :: 3.10
Python :: 3.11
Python :: 3.12
Python :: 3.13
Python :: 3.14
Python :: Implementation :: CPython
Python :: Implementation :: PyPy

Topic

Internet :: WWW/HTTP
Software Development :: Libraries :: Python Modules

🪞 PRIMP 🐍

HTTP client that can impersonate web browsers

📦 Installation

pip install -U primp

🔧 Building from Source

git clone https://github.com/deedy5/primp.git && cd primp/crates/primp-python
python -m venv .venv && source .venv/bin/activate
pip install maturin && maturin develop -r

🚀 Quick Start

Sync API

import primp

client = primp.Client(impersonate="chrome_146")
resp = client.get("https://tls.peet.ws/api/all")
print(resp.text)

Async API

import asyncio
import primp

async def main():
    async with primp.AsyncClient(impersonate="chrome_146") as client:
        resp = await client.get("https://tls.peet.ws/api/all")
        print(resp.text)

asyncio.run(main())

More examples

See the examples directory.

📊 Benchmark

🎭 Browser profiles

Browser	Profiles
Chrome	`chrome_144`, `chrome_145`, `chrome_146`, `chrome`
Safari	`safari_18.5`, `safari_26`, `safari_26.3`, `safari`
Edge	`edge_144`, `edge_145`, `edge_146`, `edge`
Firefox	`firefox_140`, `firefox_146`, `firefox_147`, `firefox_148`, `firefox`
Opera	`opera_126`, `opera_127`, `opera_128`, `opera_129`, `opera`
Random	`random`

OS: android, ios, linux, macos, windows, random

📖 Documentation

Browser Impersonation — profiles, OS, TLS/HTTP2 fingerprinting
Client — constructor, methods, authentication
AsyncClient — async API, concurrency
Response — properties, streaming
Exceptions — error handling

Disclaimer

This tool is for educational purposes only. Use it at your own risk.

Wheel compatibility matrix

Platform	CPython >=3.10 (abi3)	CPython (additional flags: t) 3.14
macosx_10_12_x86_64
macosx_11_0_arm64
manylinux2014_aarch64
manylinux2014_armv7l
manylinux2014_i686
manylinux2014_ppc64le
manylinux2014_s390x
manylinux2014_x86_64
manylinux_2_17_aarch64
manylinux_2_17_armv7l
manylinux_2_17_i686
manylinux_2_17_ppc64le
manylinux_2_17_s390x
manylinux_2_17_x86_64
musllinux_1_2_aarch64
musllinux_1_2_armv7l
musllinux_1_2_i686
musllinux_1_2_x86_64
win32
win_amd64
win_arm64