Parallel Browser Automation Controller (The "Sprint" Automator)

A high-performance browser automation controller built with Python and Playwright. The system manages multiple, completely independent browser instances, pre-authenticates into a target platform, and broadcasts a time-sensitive URL to all instances simultaneously within a short execution window.

Features

• Complete Instance Independence: Each browser instance runs in a unique BrowserContext with no shared cookies, local storage, or cache.
• Fingerprint Masking: Unique User-Agents and varied viewport resolutions for each profile to mimic different hardware.
• Network Independence: Support for per-instance proxy settings (HTTP/SOCKS5) for unique IP addresses.
• Automated Pre-Authentication: Staggered login to avoid "Bulk Login" flags and maintains a "Ready" state indefinitely.
• High-Speed "Sprint" Execution: Asynchronous broadcasting triggers all instances at once with low-latency navigation.
• Web Dashboard: A clean, local dashboard to monitor proxies, manage profiles, and trigger actions.

Requirements

• Python >= 3.12
• Playwright >= 1.49

Installation

1. Clone the repository:

   git clone <your-repo-url>
   cd biruniAtten

2. Install dependencies:

   pip install -e .

3. Install Playwright browsers:

   playwright install chromium

Configuration

Copy the example configuration file to config.json and update it with your actual settings, proxy details, and credentials:

cp config.example.json config.json

Note: config.json is ignored by Git to prevent accidentally committing sensitive information.

Usage

Start the web dashboard and automation controller:

sprint

Once running, navigate to http://localhost:8000 in your browser to access the dashboard. From there, you can:

• Monitor the status and latency of your proxies.
• Add, edit, and manage your browser profiles.
• Trigger the authentication flow and the broadcast sprint.