Immich Alt Text Helper

A small Flask app that fetches recent Immich photos and helps generate high-quality Mastodon alt text via the OpenAI API.

Getting started

Create and populate a .env file (or reuse the existing api_keys file) with:

IMMICH_API_URL=https://photos.4angle.com/
IMMICH_API_KEY=your-immich-api-key
OPENAI_API_KEY=your-openai-api-key

Install dependencies and run the development server:

pip install -r requirements.txt
flask --app app run --debug

Visit http://127.0.0.1:5000 to browse recent Immich photos, view cached alt text, and request new alt text guided by optional notes.

The app stores alt text in instance/alt_text_cache.db. Remove this file to clear the cache.