feat: add safe Javis startup script

README.md

@@ -4,34 +4,46 @@ Javis ist ein langfristiges, lokal-first ausgerichtetes Projekt für einen pers
 
 ## Aktueller Stand
 
-Der erste lokale Textchat funktioniert auf Windows mit Ollama und `qwen3:8b`.
-Er bietet echte lokale Modellantworten ohne Cloud-Fallback, neue und fortsetzbare
-Sitzungen sowie SQLite-Persistenz außerhalb des Repositories.
+Der lokale Textchat funktioniert auf Windows mit Ollama und `qwen3:8b`.
+Ein optionaler Gemini-Free-Provider ist auf einem Feature-Branch vorbereitet;
+Datenschutzrouter, Nullkostenmodus und lokales Fallback sind automatisiert
+getestet, aber noch nicht von Pascal mit einem echten Key abgenommen.
 
 Noch nicht implementiert sind Obsidian-Zugriff, Serverzugriff, Sprache, Mobile
 Client und Living Mind.
 
-## Lokaler Start
+## Einfacher Start
 
-Ollama läuft in einem eigenen Terminal ausschließlich auf localhost:
+Aus dem Repository:
 
 ```powershell
-$env:OLLAMA_MODELS = 'D:\Javis-Data\ollama-models'
-$env:OLLAMA_HOST = '127.0.0.1:11434'
-& 'D:\Javis-Tools\ollama\ollama.exe' serve
+powershell -ExecutionPolicy Bypass -File .\scripts\start-javis.ps1
 ```
 
-Der Chat startet aus dem Repository in einem zweiten Terminal:
+Das Skript findet die portablen Werkzeuge standardmäßig relativ zum Laufwerk des
+Repositories, setzt Variablen nur für seinen Prozess, prüft Ollama ausschließlich
+auf `127.0.0.1:11434`, startet es bei Bedarf versteckt und öffnet den Chat. Es
+ändert weder PATH, Registry, Autostart, Windows-Dienste noch die systemweite
+PowerShell-Ausführungsrichtlinie.
 
-```powershell
-$env:UV_CACHE_DIR = 'D:\Javis-Tools\uv-cache'
-$env:JAVIS_DATA_DIR = 'D:\Javis-Data\runtime'
-& 'D:\Javis-Tools\uv\uv.exe' run javis chat
-```
+Abweichende Pfade sind über die Skriptparameter `-UvPath`, `-OllamaPath`,
+`-OllamaModels`, `-DataDir`, `-UvCacheDir` und `-PythonInstallDir` oder die
+entsprechenden `JAVIS_*`-Umgebungsvariablen möglich.
 
 Im Chat zeigt `/help` alle Befehle. Ohne `JAVIS_DATA_DIR` nutzt Javis einen
 sicheren benutzerspezifischen Plattformstandard.
 
+Gemini bleibt standardmäßig aus. Die spätere lokale Einrichtung erfolgt ohne
+Key in der Konfigurationsdatei:
+
+```powershell
+& 'D:\Javis-Tools\uv\uv.exe' run javis configure gemini
+& 'D:\Javis-Tools\uv\uv.exe' run javis secrets set gemini
+```
+
+Der Key wird bei der zweiten Zeile verdeckt eingegeben und im
+Betriebssystem-Keyring gespeichert, niemals in Git oder TOML.
+
 ## Grundregeln
 
 - Plattformunabhängiger modularer Monolith, voraussichtlich in Python.