Find a file
2025-11-15 10:54:32 +00:00
gen_photo_alt_text Initial commit 2025-11-15 10:54:32 +00:00
static Initial commit 2025-11-15 10:54:32 +00:00
templates Initial commit 2025-11-15 10:54:32 +00:00
.gitignore Initial commit 2025-11-15 10:54:32 +00:00
app.py Initial commit 2025-11-15 10:54:32 +00:00
README.md Initial commit 2025-11-15 10:54:32 +00:00
requirements.txt Initial commit 2025-11-15 10:54:32 +00:00
SPEC.md Initial commit 2025-11-15 10:54:32 +00:00

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

  1. 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
    
  2. Install dependencies and run the development server:

    pip install -r requirements.txt
    flask --app app run --debug
    
  3. 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.