Retrieves a gem by its id and/or name. If both id and name are provided, returns the gem that matches both id and name. If on

Safely get a value from a nested list by a sequence of indices. Parameters ---------- data: `list` The nested list to traver

Close the client after a certain period of inactivity, or call manually to close immediately. Parameters ----------

Run an async coroutine in a synchronous context. Handles the case where there may or may not be an existing event loop. Uses a persistent

Execute a batch of requests to Gemini API. Parameters ---------- payloads: `list[GRPC]` List of `gemini_

Check if all required dependencies are available.

Generates contents with prompt. Parameters ---------- prompt: `str` Prompt provided by user. fil

Check if running with administrator privileges.

Send http request with provided cookies.

Download ALL images and return as a batched tensor.

Extract thinking/thoughts from the first candidate.

Extract and decrypt v20 cookies from Edge. Returns a dict of {cookie_name: cookie_value}. Requires running as Administrator!

Get user data paths for all Chromium-based browsers on Windows.

Impersonate lsass.exe to get SYSTEM privilege. Required for SYSTEM DPAPI decryption.

Load cookies from a text file. File format (one per line): __Secure-1PSID=value __Secure-1PSIDTS=value Or simpl

Save the image to disk. Parameters ---------- path: `str`, optional Path to save the image, by default w

Filter images based on watermark preference. Images are tagged by client.py based on their position in the response: - Path i

Get or create an event loop for the current thread. This ensures we reuse the same loop and avoid "Event loop is closed" errors.

Get the decryption key for v10/v11 cookies.

Attempt v20 decryption using PythonForWindows. Requires running as Administrator.

Clean and extract JSON content from a Google API streaming response. The response contains multiple JSON chunks prefixed by byte counts

Get SNlM0e value as access token. Without this token posting will fail with 400 bad request. Parameters ---------- t

Convert PIL Image to ComfyUI IMAGE tensor. Args: pil_image: PIL.Image object Returns: torch.Tensor: Image tenso

Reset the timer for closing the client when a new request is made.

Save PIL image to a temporary file and return the path. Args: pil_image: PIL.Image object suffix: File extension (defaul

Convert ComfyUI IMAGE tensor to PIL Image. ComfyUI uses tensors with shape (batch, height, width, channels) with values in range [0

Chat with Gemini, optionally with multiple image inputs.

Decrypt a cookie value (v10/v11).

Extract cookies using v10/v11 decryption.

Get or create a cached Gemini client.

Edit images using text prompts. Accepts list of image tensors.

Fallback to browser_cookie3 for non-Windows platforms.

Load cookies from gemini_cookies.txt file. File format: Line 1: __Secure-1PSID value Line 2: __Secure-1PSIDTS value (

Generate images from text prompts.

XOR two byte arrays.

Decrypt a cookie value using the browser's encryption key.

Decrypt a v20 cookie value using AES-256-GCM. Format: v20 (3 bytes) + IV (12 bytes) + Ciphertext + Tag (16 bytes) After decryption,

Decrypt using CNG (Microsoft Cryptography API) with Google Chrome's key.

Derive Chrome's v20 master key based on flag.

Extract and decrypt cookies from a Chromium cookie database.

Send a get request to gemini.google.com for each group of available cookies and return the value of "SNlM0e" as access token on the first suc

Get all profile directories for a Chromium-based browser. Returns a list of paths to cookie files for all profiles.

Get the cookie decryption key for a Chromium browser on Windows.

Get the v20 master key for Edge browser. Edge uses simpler 2-stage DPAPI (no additional encryption). Requires running as Administrat

Load cookies from all supported browsers on Windows. Uses custom implementation that directly decrypts cookies, bypassing browser_co

Parse Chrome's key blob structure (for 3-stage decryption).

Parse the file name from the given path. Parameters ---------- file : `str` | `Path` Path to the file. Returns ----

Refresh the __Secure-1PSIDTS cookie and store the refreshed cookie value in cache file. Parameters ---------- cookies : `dict`

Serializes object into formatted payload ready for RPC call.

Start the background task to automatically refresh cookies.

Upload a file to Google's server using the browser's resumable upload protocol. Parameters ---------- file : `str` | `Path`

Iter over the gems in the jar.

Build an array of given size with values at specific positions.

Convert raw image bytes to ComfyUI IMAGE tensor. Args: image_bytes: bytes of an image file Returns: torch.Tenso

Check authentication status and available methods. Returns a status dict useful for debugging.

Choose a candidate from the last `ModelOutput` to control the ongoing conversation flow. Parameters ---------- index

Create a new custom gem. Parameters ---------- name: `str` Name of the custom gem. prompt: `str`

Auto unescape HTML entities in text/thoughts if any.

Delete a custom gem. Parameters ---------- gem: `Gem | str` Gem to delete, can be either a `gemini_webap

Get a list of available gems from gemini, including system predefined gems and user-created custom gems. Note that network request w

Returns a new `GemJar` containing gems that match the given filters. Parameters ---------- predefined: `bool`, optio

Recursively find all image blob arrays in a nested structure. Image blob pattern: [null/any, 1, "file

Find the image data container, using hunt-and-peck if the expected index is wrong. Returns the contai

Returns a `GemJar` object containing cached gems. Only available after calling `GeminiClient.fetch_gems()`. Returns

Get the v20 master key for Chrome browser. Chrome uses 3-stage decryption with additional AES-GCM/ChaCha20. Requires running as Admi

Extract image status from container, checking [6] then [7].

Load Gemini authentication cookies. Parameters ---------- method : str - "auto" : Try all methods (v20 if admin, v10, co

Convert object-based image container to list format. Some models (gemini-3-pro) return dict with stri

Parse Google XSSI-protected response into clean JSON.