@dougbots/pi-image-loader

Image-to-base64 tool for pi — lets image-capable models see local image files from the filesystem.

What it does

Registers an image_to_base64 tool that:

Reads an image file from disk (png, jpg, jpeg, gif, webp, svg, bmp, tif, tiff)
Converts it to a base64 image content block with the correct MIME type
Returns the image in the top-level ImageContent shape that pi/provider adapters expect

Install

# As a pi package (recommended)
pi install git:github.com/sdougbrown/pi-image-loader

# Local development
pi install /path/to/pi-image-loader

Usage

Once installed, the image_to_base64 tool is available in your pi sessions. Pass it a file path and it returns the image as pi image content backed by base64 data:

image_to_base64(filePath: "/path/to/image.png")

Supported formats: png, jpg, jpeg, gif, webp, svg, bmp, tif, tiff.

Response

The tool returns:

A text confirmation of the conversion
An image content block with top-level data and mimeType fields
Metadata in details (mimeType, fileSize, resolved path)

Dependencies

pi — the extension runtime