architect-net 1.1.4

Surgical network fingerprinting evasion engine

🏗️ Architect

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

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:[e-mail]: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