62 lines
2.1 KiB
Markdown
62 lines
2.1 KiB
Markdown
# 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.
|