Borago Vision

Frequently asked questions

The questions people ask before trying it. Short answer first, then the detail.

Do my photos get uploaded anywhere?

No. Borago reads your photos in your own folders and does everything on your computer.

There is no server that sees a photo, a thumbnail, a file name or a folder. What leaves the device is an update check to Borago Soft, a web image you explicitly allow it to fetch, and model downloads only for an installation missing its models. What leaves the device.

Does it work offline?

Yes. Every feature works with no network connection.

You need no account. Every model comes inside the package, so a first run downloads nothing. An installation missing its models offers to download them once.

What can I search for?

What is in the picture, in your own words. Dates and seasons the way you say them. The text inside a photo. Colour. Where it was taken. The people you named. Your tags.

There is no fixed list of labels: a pineapple, a yellow hat and a graduation all work without being predefined. A place comes from the photo's GPS position and is named on your computer. Keywords already in the file, memory names and file names are searched too. All of it combines in one sentence, and each result says why it matched. Search.

Does it read the text in photos?

Yes. Signs, receipts, slides, whiteboards and screenshots become searchable.

Text is read on your computer in a pass that runs after every photo can already be found by content, so search is usable before it finishes. Rotated or curved text reads less well than straight text.

Does it recognise people?

It groups photos by the faces in them, on your computer, once you turn it on. You can name a group and search by the name.

Find faces is a setting in Settings, Faces, off by default and not part of the first run. The face models come with the application. Show people lists the groups: name one, and a search for that name finds its photos. Borago never names anyone itself. Face data never leaves the device under any setting, paid or free. The promise in full.

Is it always listening?

No. Listening for a wake phrase is off until you turn it on, and the tray shows when it is on.

While it is on, audio is checked in memory for the phrase and dropped. Nothing is recorded, written to disk or sent. A spoken search is understood on your computer, and the audio is gone when the search ends. Voice.

Which platforms does it run on, and can I download it now?

Yes. Version 0.0.4, an alpha, is out for macOS 11 or later on Apple Silicon and for Linux x64. There is no Intel Mac or Windows build yet.

The Mac disk image is signed with a Developer ID and notarized. On Linux there is an AppImage, which is not signed, and a deb and an rpm. Installing the deb or rpm adds Borago Vision's signed repository, so apt or dnf updates it from then on. The alpha is for trying it, and ships before most of its release checks. Downloads, and what is still checked.

How big is it and what does it download?

At least 4 GB of memory. Every model comes inside the package, so it downloads nothing to start.

The models unpack to 809 MB on the first run: content 454 MB, text 16 MB, faces 94 MB, and the voice models. An installation missing them offers them as downloads from Borago Soft, Hugging Face and GitHub instead. Every model is checked against a pinned hash before it is used. The index is budgeted at under 2 GB per million photos, and the thumbnail cache can be capped.

Does it change my photos?

No. Borago never moves, copies, renames or edits an original file.

Removing a folder from the library removes its photos from the index and leaves the files where they are. The one folder Borago writes to is its own, where an image you drop or paste into the window is saved.

Is it free? Do I need an account?

It is free, with no limit on the size of your library, and you need no account.

Everything on your computer is included: search, indexing, voice, faces, places and Enhance in Studio. A paid plan is for cloud features only, such as encrypted sync between your own computers. The cloud is not running in this alpha, so there is nothing to sign in to or pay for, and Settings, Account says the service is not reachable.

Can I edit photos in it?

Yes, in Enhance, Borago Studio's photo app, which comes with every build and opens in a window of its own. Studio's other apps are not in this build.

Open in Studio in the viewer, or E, hands Studio the photo, and saying open Studio opens it. Studio saves through the system's save dialog and never over a photo in your library. A result added to the library is saved in Borago's folder as a photo of its own, not yet linked to the original. Nothing leaves the computer from Studio. The window.

Does it sync between my computers?

Not yet. Encrypted sync is built, and Borago's cloud is not running in this alpha.

It carries your tags, memories, saved searches and a few settings, such as the wake phrases and the appearance, between your own computers. Each is encrypted on your computer before it leaves, and the server cannot read any of it. Photos, thumbnails and face data are never synced. It is part of a paid plan.

Is the index encrypted?

Yes, with a key kept in your system keychain.

That protects the index and the thumbnails from other accounts on the machine, from backups and from anyone with the disk. It does not protect them from a program running as you. Logs are encrypted with a key of their own and never record what was searched for. The index and the thumbnails.

How is it different from the photo app I already have?

It searches by what you remember, and nothing goes to a cloud.

The photo app on your computer and the cloud services each do some of this. How it compares, row by row.