Skip to content

xyproto/describeimage

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DescribeImage

Use LLMs that are running locally (or on a server defined in OLLAMA_HOST) to describe the given images.

This repository contains a command line utility that can be used to describe images with Ollama.

Requirements

Run-time requirements

  • Ollama (the service must be up and running, and there must be enough memory and CPU and/or GPU available to be able to use the user-configured LLM model for vision tasks (for example the llava model).
  • llm-manager can be used to configure which model to use for the vision task.

Build-time requirements

  • Go 1.22 or later

Installation

go install github.com/xyproto/describeimage@latest

The executable ends up in ~/go/bin unless Go has been configured to place it somewhere else.

Example use

describeimage puppy.png

Puppy

The image shows a cute puppy sitting on the sidewalk in what appears to be an urban setting. The puppy is looking directly at the camera with its tongue out, giving a playful and happy expression. It has a fluffy coat of light brown fur. In the background, there's a cityscape with tall buildings, street lamps, and a clear sky. The lighting suggests it might be late afternoon or early evening, as indicated by the warm glow on the buildings. There are no visible texts in the image.

describeimage meloncat.jpg

Melon Cat

The image shows a cat with a humorous and unusual appearance. The cat's head is covered by a large, green watermelon slice that has been cut to fit snugly over its head. The cat's eyes are visible through the watermelon, and it appears to be looking directly at the camera with a somewhat disgruntled or unimpressed expression. The background is simple and does not distract from the cat and its watermelon headpiece.

(note that it's really a lime)

General info