# Entwicklungsumgebung

Stand: 30.07.2026, Branch `feat/core-chat`.

## Installierte Werkzeuge

| Werkzeug | Version | Speicherort |
|---|---:|---|
| uv | 0.11.32 | `D:\Javis-Tools\uv` |
| CPython | 3.12.13 | `D:\Javis-Tools\python` |
| Ruff | 0.16.0 | lokale Projektumgebung `.venv` |
| VS Code Python | 2026.4.0 | Benutzerprofil von VS Code |
| VS Code Pylance | 2026.3.1 | Benutzerprofil von VS Code |
| VS Code Python Environments | 1.36.0 | Benutzerprofil von VS Code |
| VS Code Debugpy | 2026.6.0 | Abhängigkeit der Python-Erweiterung |

`uv` und Python wurden isoliert auf `D:` installiert. Eine vorhandene Python-Version wurde nicht ersetzt und der Windows-Benutzer- oder System-`PATH` wurde nicht verändert.

## Projektumgebung

- gewünschte Python-Linie: `3.12`, festgehalten in `.python-version`
- lokale Umgebung: `.venv`, durch Git ignoriert
- Abhängigkeiten: `pyproject.toml`
- reproduzierbare Auflösung: `uv.lock`
- einzige Entwicklungsabhängigkeit in dieser Phase: Ruff

Typische Befehle aus dem Repository:

```powershell
$env:UV_PYTHON_INSTALL_DIR = 'D:\Javis-Tools\python'
$env:UV_CACHE_DIR = 'D:\Javis-Tools\uv-cache'
& 'D:\Javis-Tools\uv\uv.exe' sync --dev
& 'D:\Javis-Tools\uv\uv.exe' run python -m unittest discover -s tests/unit -v
& 'D:\Javis-Tools\uv\uv.exe' run ruff check .
& 'D:\Javis-Tools\uv\uv.exe' run ruff format --check .
```

## Komfortabler Start

Der normale Start aus dem Repository benötigt nur:

```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\start-javis.ps1
```

`-ExecutionPolicy Bypass` gilt nur für diesen Prozess; das Skript ändert keine
systemweite Richtlinie. Es prüft Ollama auf Loopback, startet bei Bedarf die
portable Laufzeit versteckt und wartet höchstens 15 Sekunden. Werkzeug- und
Datenpfade können mit Parametern oder folgenden Umgebungsvariablen überschrieben
werden:

- `JAVIS_UV_PATH`
- `JAVIS_OLLAMA_PATH`
- `JAVIS_OLLAMA_MODELS`
- `JAVIS_DATA_DIR`
- `JAVIS_UV_CACHE_DIR`
- `JAVIS_PYTHON_INSTALL_DIR`

Die Standardpfade werden vom Laufwerk des Repositorys abgeleitet; persönliche
Windows-Benutzerpfade sind nicht eingebrannt. PATH, Registry, Autostart und
Windows-Dienste bleiben unverändert.