You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
[DOCS] Read attaches image files for vision models #1024
The CLI's Read tool now reads an image file as an attachment for a model that can see images (inference-gateway/cli#1599). Before, Read turned every image file away for every model, and the only way to look at a file on disk was ImageDecode, even for a vision model.
What changed, user-facing:
Read on a png, jpg, jpeg, gif or webp file, or on a file without an extension whose bytes are an image, attaches the image to the model's next message when the gateway lists image input among the model's modalities. The tool result carries the file's path and pixel size.
A text-only model, or a session without an image service, gets an error from Read that points at ImageDecode, which describes the image in words through the vision annotator.
ImageDecode itself is unchanged and still works for every model.
The docs say the opposite today, in two places:
cli.md, the "Vision-capable models and ImageDecode" section (around line 1964) and the frame sources section (around line 1568, "ImageDecode handles arbitrary images"): a vision model now reads a file on disk with Read, ImageDecode is for a text-only model or for a text description on top of the image.
github-action.md, around line 495: the guidance that an agent downloads an embedded image with WebFetch and then reads it with ImageDecode. With a vision model it reads the downloaded file with Read, and ImageDecode stays the path for a text-only session model with vision-model set.
cli.md explains that Read attaches an image file for a vision model and sends a text-only model to ImageDecode, with a one-line example of each outcome.
cli.md's frame sources and "Vision-capable models and ImageDecode" sections no longer say ImageDecode is the way to read an arbitrary image for every model.
github-action.md's image guidance names Read for a vision session model and ImageDecode for a text-only one with vision-model set.
cli.md Read entry: image file is attached for a vision model, with a result-line example and the ImageDecode error example for a text-only model or a session without an image service
cli.md frame sources: the "ImageDecode handles arbitrary images" line now splits by model (Read for vision, ImageDecode for text-only), and the annotator paragraph reframes ImageDecode as the text-only path or a text description on top of an image
cli.md "Vision-capable models and ImageDecode": adds the on-disk file case to the same split
github-action.md: after the WebFetch download, a vision session model reads the file with Read and a text-only one with ImageDecode side-calling vision-model
bun run lint:md, bun run format:check, bun run build - all pass
Private-repo attachment limitation and the vision-model input table row were left as-is - both are still accurate.
| Branch: docs/issue-1024-20261021-1346
Activity
edenreich commentedon Oct 21, 2026
@claude can you document this?
inference-gateway-maintainer commentedon Oct 21, 2026
Claude finished @edenreich's task in 2m 28s —— View job •
docs/issue-1024-20261021-1346• [Create PR ➔](https://github.com/inference-gateway/docs/compare/main...docs/issue-1024-20261021-1346?quick_pull=1&title=Issue%20%231024%3A%20Changes%20from%20Claude&body=This%20PR%20addresses%20issue%20%231024%0A%0AGenerated%20with%20%5BClaude%20Code%5D(https%3A%2F%2Fclaude.ai%2Fcode)Documented: Read attaches image files for vision models
cli.mdRead entry, frame sources, vision section,github-action.mdimage guidance)cli.mdRead entry: image file is attached for a vision model, with a result-line example and the ImageDecode error example for a text-only model or a session without an image servicecli.mdframe sources: the "ImageDecode handles arbitrary images" line now splits by model (Read for vision, ImageDecode for text-only), and the annotator paragraph reframes ImageDecode as the text-only path or a text description on top of an imagecli.md"Vision-capable models and ImageDecode": adds the on-disk file case to the same splitgithub-action.md: after the WebFetch download, a vision session model reads the file withReadand a text-only one withImageDecodeside-callingvision-modelbun run lint:md,bun run format:check,bun run build- all passPrivate-repo attachment limitation and the
vision-modelinput table row were left as-is - both are still accurate.| Branch:
docs/issue-1024-20261021-1346