← all repositories
gcui-art/album-ai

Your unsorted photo pile, now a RAG knowledge base

Because manually tagging terabytes of photos is a losing battle.

791 stars TypeScript RAG · SearchChat Assistants
album-ai
Not currently ranked — collecting fresh signals.
star history

What it does

Album AI ingests images from a local folder and automatically generates metadata using gpt-4o-mini and Anthropic’s Haiku. It vectorizes that text with OpenAI’s Embedding API, stores everything in PostgreSQL, and exposes both a traditional search endpoint and a RAG chat interface so you can query the collection in plain language. The authors also pitch it as an image knowledge base to feed downstream LLM content generation.

The interesting bit

The whole thing was built in under 24 hours by a photography enthusiast tired of manually cataloging terabytes of shots. It is essentially glue code—vision APIs generate captions, embedding APIs handle vectors, Postgres stores the results, and a thin layer provides search and chat—but the assembly is the point. It treats your local image folder as a living document corpus rather than a static gallery.

Key highlights

  • Uses gpt-4o-mini and Haiku for automatic image metadata extraction.
  • Vectorizes metadata via OpenAI’s Embedding API for semantic search and RAG retrieval.
  • Exposes two APIs: a traditional search endpoint and a conversational chat endpoint.
  • Supports Docker-based deployment to platforms like Render.
  • Licensed under Apache 2.0, though the authors ask you to contact them for commercial use.

Caveats

  • Server deployment docs are still a work in progress; the authors recommend local runs for now.
  • Requires live OpenAI and Anthropic API keys, and possibly a proxy, so it does not run fully offline.
  • Commercial use requires explicit contact with the authors despite the Apache 2.0 license.

Verdict

Worth a spin for photography enthusiasts with unwieldy local archives and developers who want a reference RAG pipeline over images. Skip it if you need a fully offline solution or a polished, production-grade photo manager.

Frequently asked

What is gcui-art/album-ai?
Because manually tagging terabytes of photos is a losing battle.
Is album-ai open source?
Yes — gcui-art/album-ai is open source, released under the Apache-2.0 license.
What language is album-ai written in?
gcui-art/album-ai is primarily written in TypeScript.
How popular is album-ai?
gcui-art/album-ai has 791 stars on GitHub.
Where can I find album-ai?
gcui-art/album-ai is on GitHub at https://github.com/gcui-art/album-ai.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.