# Javis

Javis ist ein langfristiges, lokal-first ausgerichtetes Projekt für einen persönlichen, modularen KI-Assistenten. Das Ziel umfasst später Textchat, Gedächtnis, Aufgaben und Notizen, kontrollierte Werkzeuge, technische Statusabfragen, Sprache und eine beobachtende Living-Mind-Oberfläche.

## 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.

Noch nicht implementiert sind Obsidian-Zugriff, Serverzugriff, Sprache, Mobile
Client und Living Mind.

## Lokaler Start

Ollama läuft in einem eigenen Terminal ausschließlich auf localhost:

```powershell
$env:OLLAMA_MODELS = 'D:\Javis-Data\ollama-models'
$env:OLLAMA_HOST = '127.0.0.1:11434'
& 'D:\Javis-Tools\ollama\ollama.exe' serve
```

Der Chat startet aus dem Repository in einem zweiten Terminal:

```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
```

Im Chat zeigt `/help` alle Befehle. Ohne `JAVIS_DATA_DIR` nutzt Javis einen
sicheren benutzerspezifischen Plattformstandard.

## Grundregeln

- Plattformunabhängiger modularer Monolith, voraussichtlich in Python.
- Lokal-first; Cloudanbieter sind optionale und standardmäßig deaktivierte Adapter.
- Keine Secrets im Code, in Git, in Prompts oder Logs.
- Keine freie Shell für ein Sprachmodell.
- Obsidian-Verknüpfungen bilden nur echte inhaltliche Beziehungen ab. Eine gehirnartige Graphansicht soll aus sinnvoller Struktur entstehen, nicht aus Dekorationslinks.
- Kritische oder schreibende Aktionen benötigen klar definierte Berechtigungen und Freigaben.

## Orientierung

- [Projektstatus](docs/PROJECT_STATUS.md)
- [Roadmap](docs/ROADMAP.md)
- [Architektur](docs/ARCHITECTURE.md)
- [Lokales Modell](docs/LOCAL_MODEL.md)
- [Entwicklungsumgebung](docs/DEVELOPMENT_SETUP.md)
- [Sicherheit](docs/SECURITY.md)
- [Nächste Sitzung](docs/NEXT_SESSION.md)
- [Kompakter Handoff](docs/CHATGPT_HANDOFF.md)

## Historischer Verbindungstest

Der bisherige Inhalt von `READ.ME` wird hier unverändert erhalten:

> Hi. Test Commit f?r verkn?pfung