lithium-web 1.0b1__py3-none-any.whl

lithium/__init__.py

@@ -0,0 +1,8 @@
+from .client import Client, Config, AsyncClient
+from .response import Response, RequestInfo, NetworkLog
+from .session import Session
+from .dom import Dom
+from .element import Element
+
+__all__ = ["Client", "Config", "AsyncClient", "Response", "Session", "Dom", "Element", "RequestInfo", "NetworkLog"]
+__version__ = "1.0b1"

lithium/bin/.lithium/fingerprints/canvas-noise-a.json

@@ -0,0 +1,25 @@
+{
+  "name": "canvas-noise-a",
+  "platform": "windows",
+  "browser": "chrome",
+  "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36",
+  "sec_ch_ua": "\"Not?A_Brand\";v=\"99\", \"Chromium\";v=\"133\", \"Google Chrome\";v=\"133\"",
+  "sec_ch_ua_platform": "\"Windows\"",
+  "sec_ch_ua_mobile": "?0",
+  "navigator_platform": "Win32",
+  "vendor": "Google Inc.",
+  "accept_language": "en-GB, en",
+  "languages": [
+    "en-GB",
+    "en"
+  ],
+  "hardware_concurrency": 4,
+  "device_memory": 4,
+  "has_device_memory": true,
+  "has_chrome_object": true,
+  "is_brave": false,
+  "gpu_vendor": "Google Inc. (AMD)",
+  "gpu_renderer": "ANGLE (AMD, AMD Radeon RX 6700 XT Direct3D11 vs_5_0 ps_5_0, D3D11)",
+  "browser_version": "133",
+  "created_at": "2026-09-01"
+}

lithium/bin/.lithium/fingerprints/canvas-noise-b.json

@@ -0,0 +1,26 @@
+{
+  "name": "canvas-noise-b",
+  "platform": "windows",
+  "browser": "brave",
+  "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36",
+  "sec_ch_ua": "\"Chromium\";v=\"133\", \"Brave\";v=\"133\", \"Not.A/Brand\";v=\"99\"",
+  "sec_ch_ua_platform": "\"Windows\"",
+  "sec_ch_ua_mobile": "?0",
+  "navigator_platform": "Win32",
+  "vendor": "Google Inc.",
+  "accept_language": "fr-FR, fr, en",
+  "languages": [
+    "fr-FR",
+    "fr",
+    "en"
+  ],
+  "hardware_concurrency": 8,
+  "device_memory": 8,
+  "has_device_memory": true,
+  "has_chrome_object": true,
+  "is_brave": true,
+  "gpu_vendor": "Google Inc. (AMD)",
+  "gpu_renderer": "ANGLE (AMD, AMD Radeon RX 580 Series Direct3D11 vs_5_0 ps_5_0, D3D11)",
+  "browser_version": "133",
+  "created_at": "2026-09-01"
+}

lithium/bin/.lithium/fingerprints/conc-tab-924755-0.json

@@ -0,0 +1,26 @@
+{
+  "name": "conc-tab-924755-0",
+  "platform": "windows",
+  "browser": "brave",
+  "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36",
+  "sec_ch_ua": "\"Chromium\";v=\"133\", \"Brave\";v=\"133\", \"Not.A/Brand\";v=\"99\"",
+  "sec_ch_ua_platform": "\"Windows\"",
+  "sec_ch_ua_mobile": "?0",
+  "navigator_platform": "Win32",
+  "vendor": "Google Inc.",
+  "accept_language": "fr-FR, fr, en",
+  "languages": [
+    "fr-FR",
+    "fr",
+    "en"
+  ],
+  "hardware_concurrency": 8,
+  "device_memory": 16,
+  "has_device_memory": true,
+  "has_chrome_object": true,
+  "is_brave": true,
+  "gpu_vendor": "Google Inc. (Intel)",
+  "gpu_renderer": "ANGLE (Intel, Intel(R) UHD Graphics 630 Direct3D11 vs_5_0 ps_5_0, D3D11)",
+  "browser_version": "133",
+  "created_at": "2026-09-01"
+}

lithium/bin/.lithium/fingerprints/conc-tab-924755-1.json

@@ -0,0 +1,25 @@
+{
+  "name": "conc-tab-924755-1",
+  "platform": "windows",
+  "browser": "chrome",
+  "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36",
+  "sec_ch_ua": "\"Not?A_Brand\";v=\"99\", \"Chromium\";v=\"133\", \"Google Chrome\";v=\"133\"",
+  "sec_ch_ua_platform": "\"Windows\"",
+  "sec_ch_ua_mobile": "?0",
+  "navigator_platform": "Win32",
+  "vendor": "Google Inc.",
+  "accept_language": "en-US, en",
+  "languages": [
+    "en-US",
+    "en"
+  ],
+  "hardware_concurrency": 8,
+  "device_memory": 8,
+  "has_device_memory": true,
+  "has_chrome_object": true,
+  "is_brave": false,
+  "gpu_vendor": "Google Inc. (AMD)",
+  "gpu_renderer": "ANGLE (AMD, AMD Radeon RX 6700 XT Direct3D11 vs_5_0 ps_5_0, D3D11)",
+  "browser_version": "133",
+  "created_at": "2026-09-01"
+}

lithium/bin/.lithium/fingerprints/conc-tab-924755-2.json

@@ -0,0 +1,26 @@
+{
+  "name": "conc-tab-924755-2",
+  "platform": "windows",
+  "browser": "firefox",
+  "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:153.0.4) Gecko/20100101 Firefox/153.0.4",
+  "sec_ch_ua": "",
+  "sec_ch_ua_platform": "",
+  "sec_ch_ua_mobile": "",
+  "navigator_platform": "Win32",
+  "vendor": "",
+  "accept_language": "de-DE, de, en",
+  "languages": [
+    "de-DE",
+    "de",
+    "en"
+  ],
+  "hardware_concurrency": 4,
+  "device_memory": 8,
+  "has_device_memory": true,
+  "has_chrome_object": false,
+  "is_brave": false,
+  "gpu_vendor": "NVIDIA Corporation",
+  "gpu_renderer": "NVIDIA GeForce RTX 3060/PCIe/SSE2",
+  "browser_version": "153.0.4",
+  "created_at": "2026-09-01"
+}

lithium/bin/.lithium/fingerprints/conc-tab-924755-3.json

@@ -0,0 +1,25 @@
+{
+  "name": "conc-tab-924755-3",
+  "platform": "windows",
+  "browser": "chrome",
+  "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36",
+  "sec_ch_ua": "\"Not?A_Brand\";v=\"99\", \"Chromium\";v=\"133\", \"Google Chrome\";v=\"133\"",
+  "sec_ch_ua_platform": "\"Windows\"",
+  "sec_ch_ua_mobile": "?0",
+  "navigator_platform": "Win32",
+  "vendor": "Google Inc.",
+  "accept_language": "en-US, en",
+  "languages": [
+    "en-US",
+    "en"
+  ],
+  "hardware_concurrency": 8,
+  "device_memory": 8,
+  "has_device_memory": true,
+  "has_chrome_object": true,
+  "is_brave": false,
+  "gpu_vendor": "Google Inc. (Intel)",
+  "gpu_renderer": "ANGLE (Intel, Intel(R) UHD Graphics 630 Direct3D11 vs_5_0 ps_5_0, D3D11)",
+  "browser_version": "133",
+  "created_at": "2026-09-01"
+}

lithium/bin/.lithium/fingerprints/one-off-override.json

@@ -0,0 +1,26 @@
+{
+  "name": "one-off-override",
+  "platform": "macos",
+  "browser": "firefox",
+  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:153.0.3) Gecko/20100101 Firefox/153.0.3",
+  "sec_ch_ua": "",
+  "sec_ch_ua_platform": "",
+  "sec_ch_ua_mobile": "",
+  "navigator_platform": "MacIntel",
+  "vendor": "",
+  "accept_language": "es-ES, es, en",
+  "languages": [
+    "es-ES",
+    "es",
+    "en"
+  ],
+  "hardware_concurrency": 8,
+  "device_memory": 8,
+  "has_device_memory": true,
+  "has_chrome_object": false,
+  "is_brave": false,
+  "gpu_vendor": "Apple Inc.",
+  "gpu_renderer": "Apple M1 Pro",
+  "browser_version": "153.0.3",
+  "created_at": "2026-09-01"
+}

lithium/bin/.lithium/fingerprints/persist-check-924755.json

@@ -0,0 +1,26 @@
+{
+  "name": "persist-check-924755",
+  "platform": "linux",
+  "browser": "chrome",
+  "user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36",
+  "sec_ch_ua": "\"Not?A_Brand\";v=\"99\", \"Chromium\";v=\"133\", \"Google Chrome\";v=\"133\"",
+  "sec_ch_ua_platform": "\"Linux\"",
+  "sec_ch_ua_mobile": "?0",
+  "navigator_platform": "Linux x86_64",
+  "vendor": "Google Inc.",
+  "accept_language": "fr-FR, fr, en",
+  "languages": [
+    "fr-FR",
+    "fr",
+    "en"
+  ],
+  "hardware_concurrency": 8,
+  "device_memory": 4,
+  "has_device_memory": true,
+  "has_chrome_object": true,
+  "is_brave": false,
+  "gpu_vendor": "Google Inc. (Intel Open Source Technology Center)",
+  "gpu_renderer": "ANGLE (Intel Open Source Technology Center, Mesa DRI Intel(R) HD Graphics 4600 (HSW GT2), OpenGL 4.5)",
+  "browser_version": "133",
+  "created_at": "2026-09-01"
+}

lithium/bin/.lithium/fingerprints/separation-924755.json

@@ -0,0 +1,26 @@
+{
+  "name": "separation-924755",
+  "platform": "linux",
+  "browser": "chrome",
+  "user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
+  "sec_ch_ua": "\"Not?A_Brand\";v=\"99\", \"Chromium\";v=\"131\", \"Google Chrome\";v=\"131\"",
+  "sec_ch_ua_platform": "\"Linux\"",
+  "sec_ch_ua_mobile": "?0",
+  "navigator_platform": "Linux x86_64",
+  "vendor": "Google Inc.",
+  "accept_language": "en-CA, en, fr",
+  "languages": [
+    "en-CA",
+    "en",
+    "fr"
+  ],
+  "hardware_concurrency": 8,
+  "device_memory": 4,
+  "has_device_memory": true,
+  "has_chrome_object": true,
+  "is_brave": false,
+  "gpu_vendor": "Google Inc. (Intel Open Source Technology Center)",
+  "gpu_renderer": "ANGLE (Intel Open Source Technology Center, Mesa DRI Intel(R) HD Graphics 4600 (HSW GT2), OpenGL 4.5)",
+  "browser_version": "131",
+  "created_at": "2026-09-01"
+}

lithium/client.py

@@ -0,0 +1,380 @@
+import asyncio
+import json as jsonlib
+import uuid
+from urllib.parse import urlencode
+
+from .transport import connection
+from .response import Response, NetworkLog
+from .session import Session
+from .utils import LithiumError
+
+
+class Config:
+
+    def __init__(self, file=None, profile="chrome-windows", fingerprint=None, platform=None, browser=None, proxy=None,
+                 verify_ssl=True, trust_env=True, execute_scripts=False, js_timeout=10.0, timeout=30.0,
+                 solution=False, shared=True, verbose=False, binary=None,
+                 auto_location=None, auto_timezone=None, auto_currency=None, auto_language=None,
+                 virtual_gpu=True, canvas_noise=True, tls_spoof=None, http3=False,
+                 socket_timeout=None, storage_file=None,
+                 viewport_width=None, viewport_height=None, device_scale_factor=None, screen_color_depth=None,
+                 hardware_concurrency=None, device_memory=None, max_touch_points=None, do_not_track=None,
+                 audio_sample_rate=None, screenshot_width=None, screenshot_height=None,
+                 max_idle_conns=None, max_idle_conns_per_host=None, geo_url=None,
+                 proxies=None, max_redirects=None, ca_cert=None, client_cert=None, client_key=None):
+        data = {}
+        if file:
+            with open(file) as f:
+                data = jsonlib.load(f)
+
+        self.profile = data.get("profile", profile)
+        self.fingerprint = data.get("fingerprint", fingerprint)
+        self.platform = data.get("platform", platform)
+        self.browser = data.get("browser", browser)
+        self.proxy = data.get("proxy", proxy)
+        self.verify_ssl = data.get("verify_ssl", verify_ssl)
+        self.trust_env = data.get("trust_env", trust_env)
+        self.execute_scripts = data.get("execute_scripts", execute_scripts)
+        self.js_timeout = data.get("js_timeout", js_timeout)
+        self.timeout = data.get("timeout", timeout)
+        self.solution = data.get("solution", solution)
+        self.shared = data.get("shared", shared)
+        self.verbose = data.get("verbose", verbose)
+        self.binary = data.get("binary", binary)
+        self.auto_location = data.get("auto_location", auto_location)
+        self.auto_timezone = data.get("auto_timezone", auto_timezone)
+        self.auto_currency = data.get("auto_currency", auto_currency)
+        self.auto_language = data.get("auto_language", auto_language)
+        self.virtual_gpu = data.get("virtual_gpu", virtual_gpu)
+        self.canvas_noise = data.get("canvas_noise", canvas_noise)
+        self.tls_spoof = data.get("tls_spoof", tls_spoof)
+        self.http3 = data.get("http3", http3)
+        self.socket_timeout = data.get("socket_timeout", socket_timeout)
+        self.storage_file = data.get("storage_file", storage_file)
+        self.viewport_width = data.get("viewport_width", viewport_width)
+        self.viewport_height = data.get("viewport_height", viewport_height)
+        self.device_scale_factor = data.get("device_scale_factor", device_scale_factor)
+        self.screen_color_depth = data.get("screen_color_depth", screen_color_depth)
+        self.hardware_concurrency = data.get("hardware_concurrency", hardware_concurrency)
+        self.device_memory = data.get("device_memory", device_memory)
+        self.max_touch_points = data.get("max_touch_points", max_touch_points)
+        self.do_not_track = data.get("do_not_track", do_not_track)
+        self.audio_sample_rate = data.get("audio_sample_rate", audio_sample_rate)
+        self.screenshot_width = data.get("screenshot_width", screenshot_width)
+        self.screenshot_height = data.get("screenshot_height", screenshot_height)
+        self.max_idle_conns = data.get("max_idle_conns", max_idle_conns)
+        self.max_idle_conns_per_host = data.get("max_idle_conns_per_host", max_idle_conns_per_host)
+        self.geo_url = data.get("geo_url", geo_url)
+        self.proxies = data.get("proxies", proxies)
+        self.max_redirects = data.get("max_redirects", max_redirects)
+        self.ca_cert = data.get("ca_cert", ca_cert)
+        self.client_cert = data.get("client_cert", client_cert)
+        self.client_key = data.get("client_key", client_key)
+        self._proxy_index = 0
+
+
+def build_body(data, json, headers):
+    if json is not None:
+        headers.setdefault("Content-Type", "application/json")
+        return jsonlib.dumps(json).encode()
+    if data is None:
+        return None
+    if isinstance(data, (bytes, bytearray)):
+        return bytes(data)
+    if isinstance(data, str):
+        return data.encode()
+    if isinstance(data, dict):
+        headers.setdefault("Content-Type", "application/x-www-form-urlencoded")
+        return urlencode(data, doseq=True).encode()
+    raise TypeError(f"unsupported type for data=: {type(data).__name__}, use bytes, str, dict, or json=")
+
+
+def build_multipart(data, files):
+    boundary = uuid.uuid4().hex
+    parts = []
+    for k, v in (data or {}).items():
+        parts.append(f'--{boundary}\r\nContent-Disposition: form-data; name="{k}"\r\n\r\n{v}\r\n'.encode())
+    for name, item in (files or {}).items():
+        if isinstance(item, tuple):
+            filename, content = item
+        else:
+            filename, content = name, item
+        if isinstance(content, str):
+            content = content.encode()
+        head = (f'--{boundary}\r\nContent-Disposition: form-data; name="{name}"; filename="{filename}"\r\n'
+                f"Content-Type: application/octet-stream\r\n\r\n").encode()
+        parts.append(head + bytes(content) + b"\r\n")
+    parts.append(f"--{boundary}--\r\n".encode())
+    return b"".join(parts), boundary
+
+
+class Client:
+    """Undetected, requests + Selenium-style HTTP client.
+
+    Zero-config requests-style use:
+        client = Client()
+        resp = client.get("https://example.com")
+        print(resp.status_code, resp.text, resp.json())
+
+    Selenium-style page interaction (client.get returns a page):
+        page = client.get("https://example.com/login")
+        page.fill("#username", "alice")
+        page.fill("#password", "secret")
+        page.click("button[type=submit]")
+        page.wait_for("#dashboard")
+        print(page.text)
+        page.screenshot("dashboard.png")
+        for req in page.network.requests:
+            print(req.method, req.url)
+
+    Config can be passed as keywords directly:
+        client = Client(profile="chrome-windows")
+        client = Client(proxy="socks5://user:pass@host:1080", execute_scripts=True)
+    """
+
+    def __init__(self, config=None, **kwargs):
+        if config is not None and kwargs:
+            raise TypeError("pass either a Config object or keyword options, not both")
+        cfg = config or Config(**kwargs) or Config()
+        self._closed = False
+        self._timeout = cfg.timeout
+        self._cfg_proxies = cfg.proxies or []
+        self._proxy_index = 0
+
+        self._conn = connection(binary=cfg.binary, verbose=cfg.verbose, solution=cfg.solution,
+                                 shared=cfg.shared, socket_timeout=cfg.socket_timeout)
+        self._conn.connect()
+
+        payload = {
+            "profile": cfg.profile,
+            "fingerprint": cfg.fingerprint or "",
+            "platform": cfg.platform or "",
+            "browser": cfg.browser or "",
+            "proxy": cfg.proxy or "",
+            "verify_ssl": cfg.verify_ssl,
+            "trust_env": cfg.trust_env,
+            "execute_scripts": cfg.execute_scripts,
+            "js_timeout": cfg.js_timeout,
+            "timeout": cfg.timeout,
+            "storage_file": cfg.storage_file or "",
+            "virtual_gpu": cfg.virtual_gpu,
+            "canvas_noise": cfg.canvas_noise,
+            "http3": cfg.http3,
+        }
+        if cfg.auto_location is not None:
+            payload["auto_location"] = cfg.auto_location
+        if cfg.auto_timezone is not None:
+            payload["auto_timezone"] = cfg.auto_timezone
+        if cfg.auto_currency is not None:
+            payload["auto_currency"] = cfg.auto_currency
+        if cfg.auto_language is not None:
+            payload["auto_language"] = cfg.auto_language
+        if cfg.tls_spoof is not None:
+            payload["tls_spoof"] = cfg.tls_spoof
+
+        for key, val in [
+            ("viewport_width", cfg.viewport_width),
+            ("viewport_height", cfg.viewport_height),
+            ("device_scale_factor", cfg.device_scale_factor),
+            ("screen_color_depth", cfg.screen_color_depth),
+            ("hardware_concurrency", cfg.hardware_concurrency),
+            ("device_memory", cfg.device_memory),
+            ("max_touch_points", cfg.max_touch_points),
+            ("audio_sample_rate", cfg.audio_sample_rate),
+            ("screenshot_width", cfg.screenshot_width),
+            ("screenshot_height", cfg.screenshot_height),
+            ("max_idle_conns", cfg.max_idle_conns),
+            ("max_idle_conns_per_host", cfg.max_idle_conns_per_host),
+            ("max_redirects", cfg.max_redirects),
+        ]:
+            if val is not None:
+                payload[key] = val
+        if cfg.geo_url is not None:
+            payload["geo_url"] = cfg.geo_url
+        for key, val in [("ca_cert", cfg.ca_cert), ("client_cert", cfg.client_cert), ("client_key", cfg.client_key)]:
+            if val:
+                payload[key] = val
+        if cfg.do_not_track is not None:
+            payload["do_not_track"] = cfg.do_not_track
+
+        result = self._conn.call("session.create", payload)
+        self._session = Session(self._conn, result["session_id"], cfg.profile, cfg.fingerprint)
+
+    def get(self, url, headers=None, timeout=None, proxy=None, fingerprint=None, platform=None, browser=None, profile=None):
+        return self._request("GET", url, headers=headers, timeout=timeout, proxy=proxy,
+                              fingerprint=fingerprint, platform=platform, browser=browser, profile=profile)
+
+    def post(self, url, data=None, json=None, files=None, headers=None, timeout=None, proxy=None,
+              fingerprint=None, platform=None, browser=None, profile=None):
+        headers = dict(headers or {})
+        if files is not None:
+            mpbody, boundary = build_multipart(data, files)
+            headers["Content-Type"] = f"multipart/form-data; boundary={boundary}"
+        else:
+            mpbody = build_body(data, json, headers)
+        return self._request("POST", url, headers=headers, body=mpbody, timeout=timeout, proxy=proxy,
+                              fingerprint=fingerprint, platform=platform, browser=browser, profile=profile)
+
+    def put(self, url, data=None, json=None, files=None, headers=None, timeout=None, proxy=None,
+             fingerprint=None, platform=None, browser=None, profile=None):
+        headers = dict(headers or {})
+        if files is not None:
+            mpbody, boundary = build_multipart(data, files)
+            headers["Content-Type"] = f"multipart/form-data; boundary={boundary}"
+        else:
+            mpbody = build_body(data, json, headers)
+        return self._request("PUT", url, headers=headers, body=mpbody, timeout=timeout, proxy=proxy,
+                              fingerprint=fingerprint, platform=platform, browser=browser, profile=profile)
+
+    def patch(self, url, data=None, json=None, files=None, headers=None, timeout=None, proxy=None,
+               fingerprint=None, platform=None, browser=None, profile=None):
+        headers = dict(headers or {})
+        if files is not None:
+            mpbody, boundary = build_multipart(data, files)
+            headers["Content-Type"] = f"multipart/form-data; boundary={boundary}"
+        else:
+            mpbody = build_body(data, json, headers)
+        return self._request("PATCH", url, headers=headers, body=mpbody, timeout=timeout, proxy=proxy,
+                              fingerprint=fingerprint, platform=platform, browser=browser, profile=profile)
+
+    def delete(self, url, headers=None, timeout=None, proxy=None, fingerprint=None, platform=None, browser=None, profile=None):
+        return self._request("DELETE", url, headers=headers, timeout=timeout, proxy=proxy,
+                              fingerprint=fingerprint, platform=platform, browser=browser, profile=profile)
+
+    def head(self, url, headers=None, timeout=None, proxy=None, fingerprint=None, platform=None, browser=None, profile=None):
+        return self._request("HEAD", url, headers=headers, timeout=timeout, proxy=proxy,
+                              fingerprint=fingerprint, platform=platform, browser=browser, profile=profile)
+
+    def options(self, url, headers=None, timeout=None, proxy=None, fingerprint=None, platform=None, browser=None, profile=None):
+        return self._request("OPTIONS", url, headers=headers, timeout=timeout, proxy=proxy,
+                              fingerprint=fingerprint, platform=platform, browser=browser, profile=profile)
+
+    def _request(self, method, url, headers=None, body=None, timeout=None, proxy=None,
+                  fingerprint=None, platform=None, browser=None, profile=None):
+        if self._closed:
+            raise LithiumError("this client is closed, create a new Client() to make more requests")
+
+        if proxy is None and self._cfg_proxies:
+            proxy = self._next_proxy()
+
+        params = {
+            "session_id": self._session.id,
+            "method": method,
+            "url": url,
+            "headers": headers or {},
+            "timeout": timeout if timeout is not None else self._timeout,
+            "proxy": proxy or "",
+            "fingerprint": fingerprint or "",
+            "platform": platform or "",
+            "browser": browser or "",
+            "profile": profile or "",
+        }
+        if body is not None:
+            params["body"] = body
+
+        data = self._conn.call("http.fetch", params)
+        return Response(data, conn=self._conn, session_id=self._session.id)
+
+    def _next_proxy(self):
+        pool = self._cfg_proxies
+        p = pool[self._proxy_index % len(pool)]
+        self._proxy_index += 1
+        return p
+
+    def stream_to_file(self, url, path, method="GET", headers=None, body=None, timeout=None,
+                       proxy=None, fingerprint=None, platform=None, browser=None, profile=None):
+        if self._closed:
+            raise LithiumError("this client is closed, create a new Client() to make more requests")
+        if proxy is None and self._cfg_proxies:
+            proxy = self._next_proxy()
+        params = {
+            "session_id": self._session.id,
+            "method": method,
+            "url": url,
+            "headers": headers or {},
+            "timeout": timeout if timeout is not None else self._timeout,
+            "proxy": proxy or "",
+            "fingerprint": fingerprint or "",
+            "platform": platform or "",
+            "browser": browser or "",
+            "profile": profile or "",
+            "path": path,
+        }
+        if body is not None:
+            params["body"] = body
+        data = self._conn.call("http.download", params)
+        return Response(data, conn=self._conn, session_id=self._session.id)
+
+    def download(self, url, path, timeout=None, proxy=None):
+        response = self.get(url, timeout=timeout, proxy=proxy)
+        with open(path, "wb") as f:
+            f.write(response.content)
+        return path
+
+    @property
+    def network(self):
+        if self._closed:
+            raise LithiumError("this client is closed, create a new Client() to inspect network activity")
+        data = self._conn.call("network.requests", {"session_id": self._session.id})
+        return NetworkLog(data.get("requests", []))
+
+    def close(self):
+        if self._closed:
+            return
+        self._closed = True
+        try:
+            self._session.close()
+        finally:
+            self._conn.close()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *exc):
+        self.close()
+
+
+class AsyncClient:
+
+    def __init__(self, config=None, **kwargs):
+        self._client = Client(config=config, **kwargs)
+
+    async def get(self, *a, **k):
+        return await asyncio.to_thread(self._client.get, *a, **k)
+
+    async def post(self, *a, **k):
+        return await asyncio.to_thread(self._client.post, *a, **k)
+
+    async def put(self, *a, **k):
+        return await asyncio.to_thread(self._client.put, *a, **k)
+
+    async def patch(self, *a, **k):
+        return await asyncio.to_thread(self._client.patch, *a, **k)
+
+    async def delete(self, *a, **k):
+        return await asyncio.to_thread(self._client.delete, *a, **k)
+
+    async def head(self, *a, **k):
+        return await asyncio.to_thread(self._client.head, *a, **k)
+
+    async def options(self, *a, **k):
+        return await asyncio.to_thread(self._client.options, *a, **k)
+
+    async def stream_to_file(self, *a, **k):
+        return await asyncio.to_thread(self._client.stream_to_file, *a, **k)
+
+    async def download(self, *a, **k):
+        return await asyncio.to_thread(self._client.download, *a, **k)
+
+    async def close(self):
+        self._client.close()
+
+    async def __aenter__(self):
+        return self
+
+    async def __aexit__(self, *exc):
+        await self.close()
+
+    @property
+    def network(self):
+        return self._client.network