Files
Jarvis-Ai/docs/DEVELOPMENT_SETUP.md
T

1.8 KiB

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 .

Vor dem Chat wird Ollama in einem eigenen Terminal gestartet:

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

Danach:

$env:JAVIS_DATA_DIR = 'D:\Javis-Data\runtime'
& 'D:\Javis-Tools\uv\uv.exe' run javis chat

Die absoluten Pfade sind ausschließlich lokale Entwicklungsdokumentation. Der Anwendungscode darf keine festen Windows-Pfade enthalten.