Start a new multi-turn chat session with Gemini.

The session maintains conversation history so follow-up messages have full context. Pass the returned session_id to gemini_chat.

Args: model: Model name for this session. Defaults to gemini-3.0-flash.

Returns: JSON with session_id to use in subsequent gemini_chat calls.

Send a text prompt to Google Gemini and get a response.

Args: prompt: The text prompt to send to Gemini. model: Model name (e.g. 'gemini-3.0-flash', 'gemini-3.0-pro', 'gemini-3.0-flash-thinking'). Defaults to gemini-3.0-flash. session_id: Optional session ID from gemini_start_chat for multi-turn conversation with context.

Returns: Gemini's text response. When using flash-thinking model, also includes the model's reasoning process.

Generate or edit images with Gemini.

Without files: generates a new image from the text prompt. With files: edits/transforms the provided image(s) based on the prompt.

Pass conversation_id from a previous call to continue refining images in the same conversation thread (e.g. "make it more dramatic", "add rain"). You can also use a cid from the Gemini web URL (gemini.google.com/app/{cid}).

Images are saved to ~/Pictures/gemini/ and full file paths are returned.

Args: prompt: Description of the image to generate, or editing instruction (e.g. 'change the background to blue', 'make it a cartoon'). model: Model name. Defaults to gemini-3.0-flash-thinking (Nano Banana 2, supports non-square aspect ratios). files: Optional list of file paths to images to edit/transform. conversation_id: Optional list of [cid, rid, rcid] from a previous gemini_generate_image response to continue the conversation. Passing just [cid] (from browser URL) also works.

Returns: JSON with generated image paths, conversation_id for continuation, or an error message.

Upload a file (image, PDF, document, video) to Gemini and ask a question about it.

Args: file_path: Absolute path to the file to upload. prompt: Question or instruction about the file (e.g. 'What is shown in this image?'). model: Model name. Defaults to gemini-3.0-flash.

Returns: Gemini's text response about the uploaded file.

Analyze a URL — YouTube videos, webpages, articles, etc.

Gemini can watch YouTube videos and read webpages, then answer questions about their content.

Args: url: The URL to analyze (YouTube, article, webpage, etc.). prompt: Question or instruction about the content (e.g. 'Summarize this video', 'What are the key points?'). model: Model name. Defaults to gemini-3.0-flash.

Returns: Gemini's analysis of the URL content.

Re-initialise the Gemini client (refresh cookies, clear state).

Use this when you get authentication errors or want a fresh session.

Returns: Confirmation message or error.