✨ Why Architect?

Most HTTP clients are black boxes. You send a request; something happens on the wire; you get a response. Architect exposes everything in between.

By separating a clean Python API from a specialized Go sidecar, Architect lets you precisely control:

• 🔐 TLS fingerprints — spoof or study JA3/JA4 signatures with native uTLS
• 📡 HTTP/2 internals — frame ordering, header normalization, SETTINGS parameters
• 🌐 OS-level TCP stack — TTL, window size, and ECH for deep emulation fidelity
• 🍪 Session state — cookie-aware persistence + TLS session resumption

🔬 Capabilities

🚀 Technical Highlights

📦 Installation

pip install architect-net

Requirements: Python 3.10+

⚡ Quick Start

Session-based client emulation

import asyncio
import architect

async def main():
    # Emulate a Chrome 124 network environment
    session = architect.AsyncSession(architect.CHROME_124)

    response = await session.get("https://tls.peet.ws/api/all")

    if response.status_code == 200:
        data = response.json()
        print(f"✅ Verified JA3 Hash: {data['tls']['ja3_hash']}")

asyncio.run(main())

🧪 Custom Protocol Profiles

Define your own network fingerprint for granular testing and research:

import architect

RESEARCH_PROFILE = {
    "ID":         "custom_research_node",
    "TLSID":      1,        # Maps to an internal TLS profile
    "TTL":        128,      # Custom hop limit (128 = Windows)
    "TCPWindow":  65535,    # Initial TCP window size
    "UserAgent":  "Mozilla/5.0 (Windows NT 10.0; Win64; x64)..."
}

async def run_test():
    # AsyncClient is stateless — no session/cookie persistence
    client = architect.AsyncClient(profile=RESEARCH_PROFILE)
    response = await client.get("https://tls.peet.ws/api/all")
    print(response.json())

🔄 AsyncSession vs AsyncClient

⚖️ Responsible Use

Architect is built for authorized security research, protocol analysis, and educational use. It exists to help engineers understand network behavior and build more resilient systems.

⚠️ Users are solely responsible for ensuring their use of this tool complies with all applicable laws and ethical standards. Do not use Architect against systems you do not own or have explicit permission to test.

🤝 Contributing

Contributions, issues, and feature requests are welcome! Check the issues page to get started.