Jarvis-Ai/docs/DEVELOPMENT_SETUP.md

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:

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