humanize-automation

1# Humanize Automation
2 
3Replace instant programmatic interactions with human-like mouse movements, keyboard typing, and scroll patterns. Patches Playwright's API at the class level — `page.click()`, `page.type()`, `page.fill()`, and Locator methods are automatically replaced with Bézier-curved mouse paths, per-character typing with mistypes, and multi-phase scroll acceleration. One flag (`humanize=True`) enables all behavioral patches. No code changes required.
4 
5## When to Use
6 
7- Target uses behavioral bot detection (mouse trajectory analysis, typing speed profiling).
8- reCAPTCHA v3 scores are low (<0.3) despite correct browser fingerprint.
9- Target times out or challenges after rapid form submissions.
10- Need to simulate a real user browsing session for login or account creation.
11- Target uses `requestAnimationFrame`-based mouse movement tracking.
12 
13## Prerequisites
14 
15- `terminal` with python3.
16- `cloakbrowser` installed: `pip install cloakbrowser`.
17- Or standalone Playwright with custom patching: import `patch_page` from the humanize module.
18 
19## How to Run
20 
21```bash
22export TARGET="https://target.com/login"
23export OUTPUT_DIR="${OUTPUT_DIR:-./output}"
24 
25python3 - "$TARGET" <<'PY'
26import sys
27from cloakbrowser import launch
28 
29browser = launch(humanize=True)
30page = browser.new_page()
31page.goto(sys.argv[1])
32print(page.title())
33browser.close()
34PY
35```
36 
37## Quick Start
38 
39```python
40from cloakbrowser import launch
41 
42browser = launch(humanize=True)
43page = browser.new_page()
44…