Einrichtung
Der Assistent läuft komplett lokal unter Windows. Diese Schritte führen von der Umgebung bis zum ersten Start.
1. Voraussetzungen
- Windows 11 mit PowerShell
- Python 3.11 (eigene
.venv) - LM Studio – lokaler LLM-Server
- Obsidian-Vault als Wissensbasis
- Optional: Mikrofon & Lautsprecher (Sprachkanal), Nextcloud (Kalender), Telegram-/WhatsApp-Zugang
2. Geführte Installation (empfohlen)
Der geführte Installer (AtlayaNew.bat) führt dich durch Lizenz, Installationsort, Python-Umgebung und optionale Anbindungen. Alles außer der Lizenz lässt sich überspringen und später in den Einstellungen nachholen. Eine vorhandene Installation überschreibt er nie ungefragt.
3. Manuelle Einrichtung (Entwicklung)
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txtDie virtuelle Umgebung wird beim Start automatisch aktiviert.
4. Konfiguration
Die gesamte Konfiguration kommt ausschließlich aus einer zentralen TOML-Datei – nichts ist im Code fest verdrahtet. Tokens/Passwörter erst eintragen, wenn der jeweilige Kanal genutzt wird, und ihn dann zusätzlich aktivieren.
5. Stimme vorbereiten
Lege das XTTS-Modell und ein eigenes Stimmprofil (.wav) in den Stimm-Ordner. Der Pfad wird in der Konfiguration unter [voice].speaker_wav eingetragen.
6. Starten
Ein einziger Startpunkt aktiviert die Umgebung, prüft LM Studio, startet Stimmdienst, Wissens-Server, aktivierte Kanäle und die Web-API mit Dashboard und Atlaya Control.
7. Tests
Vor jedem Update lohnt ein Blick auf die automatisierten Tests:
python -m pytest tests\ -q