GETTING STARTED
Getting started with Teserra
From download to a cataloged library in about ten minutes. Each page below takes two to three minutes to read, and none of them requires anything but a Mac.
The short version
- Download Teserra, open the disk image, drag it to Applications.
- On first launch, choose where your library lives. A folder in ~/Pictures is proposed. Your first launch →
- Fill it: drop a folder, import your Eagle library, or start with the demo. Adding things →
- Let the local search model download once. From then on, describe an image to find it. Finding things →
- Optional: give the Curator your own AI key so imports get titles and tags on their own. The Curator →
Requirements. A Mac with Apple Silicon running macOS 12 or later. About 300 MB for the app and the local search model. No account.
What Teserra is, in one paragraph
A visual library that lives in a folder you own. Images, screenshots, fonts, video, PDFs, web pages and articles go in; each one gets a thumbnail, a place in your collections, and, if you want, a title, a description and tags written by an AI you control. You find things by typing a word, describing the picture, picking a color, or asking your AI agent. Delete the app and every file, every tag and every collection is still there, readable by anything.
Words we use
| WORD | MEANING |
|---|---|
| Vault | A library. A folder on your disk with your originals, small text notes next to them, and a cache. You can have several. |
| Collection | A group of items, nested as deep as you like. An item can live in several collections. |
| Curator | The AI that titles, describes and tags your items, on your own key. |
| Sidecar | The small .teserra text file next to each original that holds what you decided about it. |
| Add-on | A module you can switch off: Links, Articles, Visual search, Curator, Agent access. |