Plan limits

What counts against your plan, and exactly what the app does when a limit is reached.

The app shows your plan's numbers right after sign-in and keeps showing them, with what is used, on the account screen. This page explains what each number means for your photos.

AI requests per month

Counted only when a model really ran: the same picture or the same query answered from Opensolr's cache is free.

What uses it
photos_ingest: a tenth of a request per photo, so one request covers ten photos — the words, the search vector and the text printed in the photo are all that same tenth, never more. This is only on a plan with vector search: without it nothing is sent to be read, so photos cost no AI requests at all. photos_words: a change of tags, names or wording, up to fifty photos in one call with no picture attached; a tenth of a request per photo whose search vector was made again, so tagging five hundred photos at once is fifty requests; without vector search, or once the month's allowance is used up, it costs nothing. photos_select: a tenth of a request per typed search by meaning; the same words searched again are answered from cache and cost nothing.
When it is charged
Tags and names are saved on the phone and finished there; the sync that starts straight after carries them up, so the charge, if there is one, lands on that sync and not on the save.
Vector search

Without it photos are not read into words at all: they are indexed by date, camera, place, file name and your tags, and found by those words.

What uses it
Search by meaning.
Disk space

Descriptions only, never pictures.

What uses it
The photo documents in the index.
Search bandwidth

Resets every month.

What uses it
The searches you type, the one read of the whole index into the phone's own copy after an install or a reinstall, and the syncs that actually write something.
What saves it
The phone keeps its own copy of every document in the index, so browsing the years, months and days with their counts, the tag and name suggestions, the list of what the ticked photos already carry in the tagging sheet, and a sync with nothing to do all make no requests at all. The filter lists are asked for once and kept until a sync writes something. On top of that the phone keeps the answers it already got and reuses them for as long as you choose in the account screen, so asking the same thing twice is not paid for twice.
Indexes

Creating the phone's index fails when the account has no room left.

What uses it
One per phone.
01 · Photos per month

One AI request covers ten photos, so photos per month is the monthly AI allowance times ten, and photos left this month does the same with what is left of it. A plan with no monthly cap shows No monthly cap.

A picture is read once

Opensolr keeps its own answers: a picture it has already read is served from its cache, so emptying the index, losing it or reinstalling the app costs no AI requests for photos that went through before. Only pictures Opensolr has never seen cost an AI request. A reinstall does read the whole index back into the phone's copy once, and that one read counts against search bandwidth.

02 · On a plan without photo recognition

Photo recognition is what reads a picture: it needs a plan with vector search. Without it the app sends no picture to be read at all, and your photos are still indexed and still searched — by everything the phone itself knows about them.

What you do not get
Search by meaning
Searching matches words, not meaning, so puppy no longer finds a photo read as dog.
What a photo shows
New photos get no words of their own, so the Meaning filter and the Things section of Stats stop growing.
Text printed in a photo
Receipts, labels and screenshots are not read, so the OCR filter and Documents have nothing new to show.
The first duplicate stops
The stops built on what a photo shows find nothing new; the ones built on the camera, the date, the file name, the size and the exact copy work as before.
Half the tag suggestions
Your own tags are still suggested; the words your photos were read into are not.
What still works
Everything you wrote
Your tags, the people you named and your own wording of a photo.
Everything the photo carries
Date, camera, lens, exposure, folder, file name, and the city and country its GPS position was turned into.
The rest of the app
Stats and the filters by person, tag, year, place and camera; the map; duplicates by camera, date, name, size and exact copy; the viewer; sharing and deleting.
Nothing already read is lost

A photo that was read before keeps its words and its printed text, so moving to a plan without recognition takes nothing away from what is already in your index. Photos indexed meanwhile are read at the first sync after you get recognition back.

03 · Warnings before a limit

At 90% of the disk space, of the month's search bandwidth or of the month's AI requests, and again at the limit, the app posts one notification and shows the same warning at the top of the account screen. A plan without photo recognition is said there too: Photos are not recognised on your plan, with what that means. Each notification is posted once; the monthly ones come back every month.

04 · What happens at a limit
AI requests

Nothing stops. New photos are still indexed with everything the phone knows about them (date, camera, place, file name, your tags), only without the words Opensolr would read them into and without a vector; the Sync screen and a notification say how many. At the first sync after the allowance resets (or after an upgrade) those photos are read into words. A photo already in the index keeps the words and the printed text read out of it earlier, matched by the file's md5, so a pass that cannot read it takes nothing away. Search runs on words only meanwhile, exactly as Opensolr's own site search does on a plan without vectors.

Effect
Indexing continues without words and vectors; search by meaning falls back to words.
Disk space or bandwidth

A notification that opens your Opensolr account; the Sync screen says the index reached its disk space or bandwidth. Tagging is not blocked: tags and names go on being saved on the phone while the index is closed, and go up on the first sync after the limit clears.

Effect
Opensolr closes the index to requests until it is back under the limit; sync stops.
Indexes

The setup screen says so, with a link to the plans.

Effect
The phone's index cannot be created.

Nothing is lost. After an upgrade, or when the month rolls over, the next Re-Sync continues where the last one stopped. The notification and the account screen open your Opensolr account on opensolr.com in your browser.

Opensolr Photos is open source and MIT licensed. Questions about your Opensolr account, index or plan go to opensolr.com/contact; questions about the app itself belong on GitHub.

Opensolr Photos Documentation