Files
Jarvis-Ai/README.md

60 lines
2.2 KiB
Markdown

# 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