# itisnotnormal/funbrowser architecture

> Architecture diagram of the GitHub repository itisnotnormal/funbrowser, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/itisnotnormal/funbrowser
- Repository: https://github.com/itisnotnormal/funbrowser

## Overview

FunBrowser is a Python SDK for controlling real Chrome through CDP, with browser identity and automation features layered onto page and context workflows. The main path is a user starting a browser, opening a tab, and automating a site; optional branches add pooling, captcha solving, a dashboard, and script-level TLS impersonation. The README documents several capabilities whose internal wiring is not shown in the excerpts, so those links are documented at the README level; other links are limited to visible source references.

Main entry points: [`funbrowser/browser.py`](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/browser.py) (Browser control), [`funbrowser/tab.py`](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/tab.py) (Tab automation), [`funbrowser/context_pool.py`](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/context_pool.py) (Context pool), [`funbrowser/tls/http.py`](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/tls/http.py) (Impersonated HTTP)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Browser runtime"]
  node_browser["Browser control<br/>[browser.py]"]
  node_launcher["Chrome launcher<br/>[_launcher.py]"]
  node_cdp["CDP transport<br/>[_cdp.py]"]
  node_tab["Tab automation<br/>[tab.py]"]
  node_element["Element handles<br/>[element.py]"]
  node_context["Isolated context<br/>[context.py]"]
end

subgraph group_identity["Browser identity"]
  node_fingerprint["Fingerprint data<br/>[data.py]"]
  node_presets["Fingerprint presets<br/>[presets.py]"]
  node_stealth["Stealth patches<br/>[patches.py]"]
  node_proxy["Proxy handling<br/>[proxy.py]"]
  node_geo["Proxy geolocation<br/>[geo.py]"]
end

subgraph group_automation["Automation services"]
  node_humanly["Human-like input<br/>[humanly.py]"]
  node_solver_bridge["Captcha page bridge<br/>[bridge.py]"]
  node_solver_client["Captcha API client<br/>[client.py]"]
  node_google["Google sign-in helper<br/>[google.py]"]
  node_totp["TOTP codes<br/>[totp.py]"]
end

subgraph group_operations["Browser operations"]
  node_profile["Persistent profiles<br/>[profile.py]"]
  node_browser_pool["Browser pool<br/>[pool.py]"]
  node_context_pool["Context pool<br/>[context_pool.py]"]
  node_panel["Local web panel<br/>[panel.py]"]
end

subgraph group_tls["TLS impersonation"]
  node_tls_http["Impersonated HTTP<br/>[http.py]"]
  node_tls_ca["TLS certificates<br/>[ca.py]"]
end

node_user(("SDK user"))
node_chrome["Chrome"]
node_website["Target website"]
node_solver_service["FunSolver API"]

node_user -->|"starts"| node_browser
node_browser -->|"launches"| node_launcher
node_launcher -->|"starts"| node_chrome
node_browser -->|"connects"| node_cdp
node_browser -->|"opens"| node_tab
node_tab -->|"sends commands"| node_cdp
node_tab -->|"navigates"| node_website
node_tab -->|"queries"| node_element
node_browser -->|"creates"| node_context
node_context -->|"opens"| node_tab
node_browser -->|"accepts"| node_fingerprint
node_presets -->|"builds"| node_fingerprint
node_browser -->|"configures"| node_stealth
node_stealth -->|"applies values"| node_fingerprint
node_browser -->|"configures"| node_proxy
node_browser -->|"uses"| node_geo
node_tab -->|"uses input behavior"| node_humanly
node_tab -->|"attaches solver"| node_solver_bridge
node_solver_bridge -->|"dispatches solves"| node_solver_client
node_solver_client -->|"requests solutions"| node_solver_service
node_google -->|"drives sign-in"| node_tab
node_user -->|"requests code"| node_totp
node_browser -.->|"persists identity"| node_profile
node_user -->|"runs jobs"| node_browser_pool
node_browser_pool -->|"manages browsers"| node_browser
node_user -->|"runs jobs"| node_context_pool
node_context_pool -->|"uses shared browser"| node_browser
node_context_pool -->|"manages contexts"| node_context
node_user -->|"opens dashboard"| node_panel
node_panel -->|"controls fleet"| node_browser_pool
node_user -->|"sends HTTP request"| node_tls_http
node_tls_http -->|"requests with impersonation"| node_website
node_tls_http -->|"uses certificates"| node_tls_ca

click node_browser "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/browser.py"
click node_launcher "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/_launcher.py"
click node_cdp "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/_cdp.py"
click node_tab "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/tab.py"
click node_element "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/element.py"
click node_context "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/context.py"
click node_fingerprint "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/fingerprint/data.py"
click node_presets "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/fingerprint/presets.py"
click node_stealth "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/stealth/patches.py"
click node_proxy "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/proxy.py"
click node_geo "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/geo.py"
click node_humanly "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/humanly.py"
click node_solver_bridge "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/solver/bridge.py"
click node_solver_client "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/solver/client.py"
click node_google "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/helpers/google.py"
click node_totp "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/helpers/totp.py"
click node_profile "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/profile.py"
click node_browser_pool "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/pool.py"
click node_context_pool "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/context_pool.py"
click node_panel "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/panel.py"
click node_tls_http "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/tls/http.py"
click node_tls_ca "https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/tls/ca.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_browser,node_launcher,node_cdp,node_tab,node_element,node_context,node_user toneBlue
class node_fingerprint,node_presets,node_stealth,node_proxy,node_geo toneAmber
class node_humanly,node_solver_bridge,node_solver_client,node_google,node_totp,node_solver_service toneMint
class node_profile,node_browser_pool,node_context_pool,node_panel toneRose
class node_tls_http,node_tls_ca,node_chrome,node_website toneIndigo
```

## Components

### Browser runtime

- [Browser control](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/browser.py): `funbrowser/browser.py`
- [Chrome launcher](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/_launcher.py): `funbrowser/_launcher.py`
- [CDP transport](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/_cdp.py): `funbrowser/_cdp.py`
- [Tab automation](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/tab.py): `funbrowser/tab.py`
- [Element handles](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/element.py): `funbrowser/element.py`
- [Isolated context](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/context.py): `funbrowser/context.py`

### Browser identity

- [Fingerprint data](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/fingerprint/data.py): `funbrowser/fingerprint/data.py`
- [Fingerprint presets](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/fingerprint/presets.py): `funbrowser/fingerprint/presets.py`
- [Stealth patches](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/stealth/patches.py): `funbrowser/stealth/patches.py`
- [Proxy handling](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/proxy.py): `funbrowser/proxy.py`
- [Proxy geolocation](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/geo.py): `funbrowser/geo.py`

### Automation services

- [Human-like input](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/humanly.py): `funbrowser/humanly.py`
- [Captcha page bridge](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/solver/bridge.py): `funbrowser/solver/bridge.py`
- [Captcha API client](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/solver/client.py): `funbrowser/solver/client.py`
- [Google sign-in helper](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/helpers/google.py): `funbrowser/helpers/google.py`
- [TOTP codes](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/helpers/totp.py): `funbrowser/helpers/totp.py`

### Browser operations

- [Persistent profiles](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/profile.py): `funbrowser/profile.py`
- [Browser pool](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/pool.py): `funbrowser/pool.py`
- [Context pool](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/context_pool.py): `funbrowser/context_pool.py`
- [Local web panel](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/panel.py): `funbrowser/panel.py`

### TLS impersonation

- [Impersonated HTTP](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/tls/http.py): `funbrowser/tls/http.py`
- [TLS certificates](https://github.com/itisnotnormal/funbrowser/blob/main/funbrowser/tls/ca.py): `funbrowser/tls/ca.py`

### Other components

- **SDK user**
- **Chrome**
- **Target website**
- **FunSolver API**

## Connections

- SDK user → Browser control: starts (evidence: `README.md`)
- Browser control → Chrome launcher: launches (evidence: `funbrowser/browser.py`)
- Chrome launcher → Chrome: starts (evidence: `README.md`)
- Browser control → CDP transport: connects (evidence: `funbrowser/browser.py`)
- Browser control → Tab automation: opens (evidence: `funbrowser/browser.py`)
- Tab automation → CDP transport: sends commands (evidence: `funbrowser/tab.py`)
- Tab automation → Target website: navigates (evidence: `README.md`)
- Tab automation → Element handles: queries (evidence: `funbrowser/tab.py`)
- Browser control → Isolated context: creates (evidence: `funbrowser/browser.py`)
- Isolated context → Tab automation: opens (evidence: `funbrowser/context.py`)
- Browser control → Fingerprint data: accepts (evidence: `funbrowser/browser.py`)
- Fingerprint presets → Fingerprint data: builds (evidence: `funbrowser/fingerprint/presets.py`)
- Browser control → Stealth patches: configures (evidence: `funbrowser/browser.py`)
- Stealth patches → Fingerprint data: applies values (evidence: `funbrowser/stealth/patches.py`)
- Browser control → Proxy handling: configures (evidence: `funbrowser/browser.py`)
- Browser control → Proxy geolocation: uses (evidence: `funbrowser/browser.py`)
- Tab automation → Human-like input: uses input behavior (evidence: `funbrowser/tab.py`)
- Tab automation → Captcha page bridge: attaches solver (evidence: `funbrowser/tab.py`)
- Captcha page bridge → Captcha API client: dispatches solves (evidence: `funbrowser/solver/bridge.py`)
- Captcha API client → FunSolver API: requests solutions (evidence: `funbrowser/solver/client.py`)
- Google sign-in helper → Tab automation: drives sign-in (evidence: `funbrowser/helpers/google.py`)
- SDK user → TOTP codes: requests code (evidence: `funbrowser/helpers/totp.py`)
- Browser control → Persistent profiles: persists identity (evidence: `README.md`)
- SDK user → Browser pool: runs jobs (evidence: `README.md`)
- Browser pool → Browser control: manages browsers (evidence: `funbrowser/pool.py`)
- SDK user → Context pool: runs jobs (evidence: `README.md`)
- Context pool → Browser control: uses shared browser (evidence: `funbrowser/context_pool.py`)
- Context pool → Isolated context: manages contexts (evidence: `funbrowser/context_pool.py`)
- SDK user → Local web panel: opens dashboard (evidence: `README.md`)
- Local web panel → Browser pool: controls fleet (evidence: `funbrowser/panel.py`)
- SDK user → Impersonated HTTP: sends HTTP request (evidence: `README.md`)
- Impersonated HTTP → Target website: requests with impersonation (evidence: `README.md`)
- Impersonated HTTP → TLS certificates: uses certificates
