calesthio/OpenMontage · error · FileNotFoundError

Input file not found: {path}

Error message

Input file not found: {path}

What it means

FileNotFoundError from the Grok image tool's _file_to_data_uri helper. Before calling the x.ai images API in edit mode, a local image_path argument is read, base64-encoded, and wrapped as a data: URI; if the path does not exist on disk the helper raises before any network call happens.

Source

Thrown at tools/graphics/grok_image.py:30

from tools.base_tool import (
    BaseTool,
    Determinism,
    ExecutionMode,
    ResourceProfile,
    RetryPolicy,
    ToolResult,
    ToolRuntime,
    ToolStability,
    ToolStatus,
    ToolTier,
)


def _file_to_data_uri(path_str: str) -> str:
    path = Path(path_str)
    if not path.exists():
        raise FileNotFoundError(f"Input file not found: {path}")
    mime_type, _ = mimetypes.guess_type(path.name)
    if not mime_type:
        mime_type = "application/octet-stream"
    encoded = base64.b64encode(path.read_bytes()).decode("ascii")
    return f"data:{mime_type};base64,{encoded}"


def _normalize_image_input(url_value: str | None, path_value: str | None) -> dict[str, str] | None:
    if url_value:
        return {"url": url_value, "type": "image_url"}
    if path_value:
        return {"url": _file_to_data_uri(path_value), "type": "image_url"}
    return None


class GrokImage(BaseTool):
    name = "grok_image"
    version = "0.1.0"

View on GitHub (pinned to 95e1c3d0ab)

Solutions

1. Verify the file exists before invoking the tool (Path(p).exists())
2. Use an absolute path, or resolve relative paths against a known base directory
3. Expand '~' explicitly: str(Path(p).expanduser().resolve())
4. If the file should have been produced by an earlier pipeline step, check that step's output before retrying

Example fix

// before
inputs = {"mode": "edit", "image_path": "~/pictures/cat.png"}
// after
from pathlib import Path
p = Path("~/pictures/cat.png").expanduser().resolve()
assert p.is_file(), f"missing input: {p}"
inputs = {"mode": "edit", "image_path": str(p)}

from pathlib import Path

def valid_image_path(p: str) -> bool:
    path = Path(p).expanduser().resolve()
    return path.is_file() and path.suffix.lower() in {".png", ".jpg", ".jpeg", ".webp"}

assert valid_image_path(inputs["image_path"]) or "image_url" in inputs

try:
        result = grok_image_tool.run(inputs)
    except FileNotFoundError as e:
        # path missing; resolve or regenerate the input before retry

When it happens

Trigger: Calling grok_image with image_path (or a member of image_paths) pointing to a non-existent file: typo in the path, relative path resolved against the wrong working directory, file deleted between planning and execution, or a sandboxed agent passing a path outside its workspace.

Common situations: Relative paths like 'assets/input.png' run from a different cwd; agent-generated paths from a prior step that never materialized; unexpanded '~' in the path (the helper uses plain Path(path_str) without expanduser).

Related errors

• Input file not found: {path}
• Image not found: {image_path}
• {label} not found: {media_path}
• Edit mode requires image_url/image_path or image_urls/image_
• Reference image not found: {ref}

AI-assisted analysis of calesthio/OpenMontage@95e1c3d0ab (2026-08-15). Data as JSON: /api/errors/0d258366fc748768. Report an issue: GitHub.