Flask-Image-Search 2.0.0rc1

Image Searching For Flask and Flask-SQLAlchemy.

Flask Image Search is an extension for Flask that adds content-based image search to a Flask + Flask-SQLAlchemy app. Features are extracted with a PyTorch CNN and stored alongside your model rows; queries are ranked by L2 distance.

• Free software: MIT license

• Documentation: https://flask-image-search.readthedocs.io

Features

• Works with Flask-SQLAlchemy — search your database directly.

• Indexes update automatically when rows are added, edited, or deleted.

• Pluggable storage backends: works on any SQL dialect; opts into sqlite-vec or pgvector when available for ANN-accelerated KNN.

Install

pip install flask-image-search

See the documentation for usage, backend options, and the migration guide from 1.x.

Development

Requires Python 3.9+ and pip 25.1+:

pip install -e . --group dev
pre-commit install --hook-type pre-commit --hook-type pre-push

Common tasks (poe --help lists everything):

poe test          # run tests
poe lint          # ruff check
poe docs          # live-reload docs server
poe example       # run the demo Flask app

Cutting a release:

bump-my-version bump patch    # or: minor / major
git push --tags               # CI publishes to PyPI

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.