Case study · Photos → text
Accessibility text for 1,392 images, overnight
A collection of engineering-maths workbooks — 186 sections, thousands of diagrams — needed a written description for every image so that screen-reader users could follow them. Doing it by hand is months of work. A script did it while I slept.
The problem
Accessibility law and common decency both say images on a website need a text description. For a textbook full of graphs, circuit diagrams and geometric figures, that's a lot of careful writing, and it never gets to the top of anyone's list. The collection had sat without descriptions for years.
What I built
A program that walks through every web page in the collection, finds each image, converts it to a format the AI can see, and sends it — with the surrounding text for context — to a vision-capable AI model. The model writes a one-sentence description for the image tag and a longer, structured description on a linked page. The script records its progress in a log so it can be stopped and resumed, and skips anything already done.
Crucially, it can use a model running on a machine in the room rather than a cloud service. For this job nothing needed to leave the building. The same switch lets it use a cloud model where quality matters more than privacy.
What changed
- 1,392 images described in a run that would otherwise have taken a person months.
- A repeatable process: when a page changes, re-run it and only the new images are done.
- A generic version of the script that works on any folder of web pages, packaged and shared with other institutions after the conference talk.
Time and cost
A few days to build and check. Running on a local model, the cost was electricity. Using a cloud model instead would have been in the tens of pounds for the whole collection.
What this could mean for your business
- Online shops and marketplaces: consistent product descriptions and alt text from a folder of photos, in your tone of voice, in bulk.
- Estate and letting agents: room-by-room descriptions from listing photos.
- Any website: meet accessibility requirements without a rewrite. Public bodies and anyone selling to them will increasingly ask for this.
- Anyone with photos of jobs: before/after write-ups for your website and social media from the pictures your team already takes.
Got something similar? Book a free 30-minute chat and describe it. If it's a one- or two-day build, I'll quote a fixed price on the spot.