Skip to main content

Surgical network fingerprinting evasion engine

Project description

🏗️ Architect

"The Stealthy Network Chameleon" 🦎
Surgical network fingerprinting for the modern web.

PyPI Version Go Version Python Version Asyncio Support License: MIT

Architect is an elite low-level network engine designed to blend in perfectly. It surgically manipulates your network stack across every layer to produce TLS signatures, HTTP/2 frames, and TCP signatures that are indistinguishable from real browsers.

Bypass enterprise-grade WAFs like Cloudflare, Akamai, and DataDome with ease. 🛡️✨


🧐 Why Architect?

Standard networking libraries (like Python's requests or Go's net/http) are easily flagged because they leave "digital fingerprints" at every layer. Architect wipes those fingerprints clean by running a high-performance Go sidecar that handles the raw protocol work.

🦎 The Stealth Stack:

  • Layer 3 (Network): Spoofs TTL and TCP Window Size to match specific Operating Systems.
  • Layer 4 (Transport): Uses uTLS for perfect JA3/JA4 signatures and Encrypted Client Hello (ECH) to hide SNI.
  • Layer 7 (Application): Wire-level HTTP/2 Header Ordering and frame manipulation to match browser behavior.
  • Behavioral: Full Cookie Session persistence and TLS session resumption.

🚀 Key Features

  • ⚡ Zero-Friction User Experience: Just pip install. Pre-compiled binaries for Windows, Linux, and macOS are bundled in the wheel.
  • ⚡ Asyncio Native: Designed for high-scale concurrency with AsyncClient and AsyncSession.
  • 🌐 Full HTTP Method Support: Effortlessly execute GET, POST, PUT, DELETE, PATCH, HEAD, and OPTIONS requests.
  • 🔄 Identity Rotation: Switch fingerprints (Chrome, Safari, etc.) or inject custom profiles on the fly.
  • 🔌 Proxy Dominance: Full SOCKS5 and HTTP proxy support with isolated connection pools.
  • 🔍 Deep Visibility: Stream real-time engine logs to see exactly how handshakes are performing.

📦 Installation

The Easy Way (Users) 💅

pip install architect-net

Architect bundles pre-compiled Go binaries—no Go installation required!

Building from Source 🏗️

# 1. Clone and compile the engine sidecars
python scripts/build_engine.py

# 2. Install in editable mode
pip install -e .

📖 Usage Examples

🐍 Basic Async Session

import asyncio
import architect

async def main():
    # Maintains cookies & TLS state automatically!
    session = architect.AsyncSession(architect.CHROME_124)
    
    # 🦎 Perfect emulation through a residential proxy
    session.proxy = "socks5://user:pass@p.proxy.net:8000"
    
    response = await session.get("https://tls.peet.ws/api/all")
    print(f"Bypassed! Status: {response.status_code} 🎉")
    
    # Peek at the digital wire:
    for log in session.get_logs():
        print(f"[ENGINE]: {log}")

if __name__ == "__main__":
    asyncio.run(main())

🧬 Dynamic Custom Profiles

Define your own identity in pure Python—no Go recompilation needed:

MY_IDENTITY = {
    "ID": "custom_m1_mac",
    "TLSID": {"Client": "Chrome", "Version": "120"}, # Chrome-based uTLS
    "TTL": 64,           # MacOS TTL
    "TCPWindow": 64240,  # MacOS Window Size
    "UserAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)..."
}

client = architect.Client(profile=MY_IDENTITY)

🐹 Go (Pure Performance)

import "github.com/hiericho/architect/core"

func main() {
    client := architect.NewClient(architect.Chrome124)
    resp, _ := client.Get("https://tls.peet.ws/api/all")
}

📂 Project Structure

architect/
├── engine/         # ⚙️ Go Proxy Engine (Sidecar Source)
├── architect/      # 🐍 Python Package (Public API)
│   └── bin/        # 📦 Bundled Cross-compiled Engine Binaries
├── scripts/        # 🏗️ Build and automation scripts
├── core/           # 🧩 Core Go Logic
└── README.md       # 📖 You are here!

📜 Disclaimer

Architect is intended for educational use and authorized security testing only. Don't be a mean chameleon! The authors assume no liability for misuse.


Made with ❤️ by Hiericho

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

architect_net-1.1.5.tar.gz (17.0 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

architect_net-1.1.5-py3-none-any.whl (17.1 MB view details)

Uploaded Python 3

File details

Details for the file architect_net-1.1.5.tar.gz.

File metadata

  • Download URL: architect_net-1.1.5.tar.gz
  • Upload date:
  • Size: 17.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for architect_net-1.1.5.tar.gz
Algorithm Hash digest
SHA256 cd7f2d8eecc03e9a15fd593498bf0e95213122bfeb01687bf9699ce5b6e025fd
MD5 63bc3c16bbf3ec0717d0f55370280799
BLAKE2b-256 1596ab4a54a8da99073339457448d1739952e7824d20b060abed7efc2e9b8a40

See more details on using hashes here.

File details

Details for the file architect_net-1.1.5-py3-none-any.whl.

File metadata

  • Download URL: architect_net-1.1.5-py3-none-any.whl
  • Upload date:
  • Size: 17.1 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for architect_net-1.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 279a269768bd562d34a9e70fb0ef1f787aa36c1d21d0e62b9f39366d3c0df5c4
MD5 7ba201c9349d23321e4553a18e1c1009
BLAKE2b-256 b5209124d4033b80b40099828203a1f5f30d31b4f69fb9726e5d021241fba0c1

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page