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.6.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.6-py3-none-any.whl (17.1 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: architect_net-1.1.6.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.6.tar.gz
Algorithm Hash digest
SHA256 2f9cee7d569bf7e24c8d4cdf426e653ddce4d288d50e905d35a6fd14dea15484
MD5 cac5a02b979dbb3f14cd60abc6898198
BLAKE2b-256 916649c0f4e0429f6aa2c748e2d9fe909e323350c3eb0853f84aa70abf4fcd8c

See more details on using hashes here.

File details

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

File metadata

  • Download URL: architect_net-1.1.6-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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 d02fb2eeb004888c5e058ff8215b027463b3eb7e2678d81ef207b422de1d270a
MD5 1e570d23f873a14c0dc404c4b810a178
BLAKE2b-256 5aafc29f50b7d10e3dc61b23fc94427ed59fd4b9f92e8270849874328edbd522

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