Look at an image and answer a question about it.

This is the core vision tool. Use it whenever you need to understand, describe, or reason about visual content that you cannot see.

Args: image: The image to analyze. Accepts: - A local file path (e.g. /home/user/photo.jpg) - An HTTP(S) URL (e.g. https://example.com/img.png) - A base64-encoded string (with or without data-URI prefix) question: What you want to know about the image. Default: "What is in this image?"

Returns: The vision model's answer as plain text.

Examples: >>> see_image("/tmp/screenshot.png", "What error is shown in this dialog?") >>> see_image("https://example.com/chart.png", "What's the trend?") >>> see_image("iVBORw0KGgo...", "Is this a cat or a dog?")

Generate a text description of an image.

Useful when you need a caption, alt text, or a general summary of what an image contains without asking a specific question.

Args: image: The image to describe (file path, URL, or base64). detail_level: How detailed the description should be. Options: "brief", "detailed", "exhaustive". Default: "detailed".

Returns: A text description of the image.

Examples: >>> describe_image("/tmp/product.jpg") >>> describe_image("https://site.com/scene.png", "brief")

Extract (OCR) all visible text from an image.

Ideal for screenshots of documents, code, error messages, or any image where the text content matters more than the visual appearance.

Args: image: The image containing text (file path, URL, or base64). language_hint: Optional hint about the text language (e.g. "Chinese", "English", "mixed"). Helps the model focus on the right character set.

Returns: All text found in the image, preserving layout where possible.

Examples: >>> extract_text("/tmp/error_screenshot.png") >>> extract_text("/tmp/receipt.jpg", "Chinese")

Analyze a chart, graph, diagram, or UI screenshot.

Specialised for understanding data visualisations, technical diagrams, flowcharts, and UI screenshots where spatial layout and relationships matter.

Args: image: The chart/diagram image (file path, URL, or base64). question: Optional specific question about the chart. If empty, a general analysis is performed.

Returns: A text analysis of the chart or diagram.

Examples: >>> analyze_chart("/tmp/q1_revenue.png") >>> analyze_chart("/tmp/architecture.png", "What are the main components?")