docs: add user-facing copy-and-paste agent installation prompt

README.md

@@ -80,9 +80,48 @@ published yet.** Windows, macOS and Linux are the intended desktop platforms;
 packaged releases and platform testing are still being completed.
 
 Check the [releases page](https://tea.karlcom.de/karl/searchi/releases) for
-published downloads. If you want to try the current source version, follow
+published downloads, or let your local AI agent handle setup for you.
-the [build and launch instructions](docs/BUILDING.md). Building it currently
+
-requires development tools.
+### Install with your agent — copy and paste
+
+Paste this into an agent that can run commands on your computer:
+
+```text
+Install searchi on this computer and get it ready for my first search.
+Official repository: https://tea.karlcom.de/karl/searchi
+
+Detect my operating system and processor architecture. Use a suitable official
+release if one is available, verifying any published checksums. Otherwise,
+set up the current source version using the repository's installation/build
+instructions. Handle the required tools and dependencies for me; don't just
+give me a list of commands to run. Keep the installation in a dedicated folder
+and preserve any existing searchi settings and index.
+
+Install the desktop app by default. On headless Linux, install the command-line
+version instead, without desktop dependencies. Set up the genuine local Google
+EmbeddingGemma 2 runtime and model, and the media helpers available for my
+platform. Use supported hardware acceleration with CPU fallback. Explain any
+large downloads or platform limitations before proceeding with those steps.
+
+Launch searchi and check that it actually opens and its local search model is
+ready. Create a normal launcher or shortcut so I can open it again. If a prerequisite, platform component
+or permission prevents setup, explain precisely what is missing; don't report
+a working installation until it is verified. Ask for my help only when a
+password, system approval or other manual action is required.
+
+Let me choose which folders to index. Keep search local and optional cloud
+summaries disabled. Finish by showing me how to add a folder and try a filename
+search followed by a search in my own words.
+```
+
+Your agent needs internet access and permission to install software locally.
+Since installers aren't published yet, setup currently involves building the
+app and may take a while. The local search model downloads approximately
+**865 MB**. Windows, macOS and Linux release validation is still in progress;
+your agent should report any platform limitation it encounters.
+
+Prefer to set it up yourself? See the
+[build and launch instructions](docs/BUILDING.md).
 
 ### Your first search