build: configure Python development environment
This commit is contained in:
+20
-11
@@ -50,7 +50,10 @@ Rootserver:
|
||||
- Konfigurationsbeispiel, Sicherheitsdokumente, ADRs und Strukturtest sind vorhanden.
|
||||
- Living-Mind-Verzeichnis ist ausschließlich ein inaktiver Vertrag ohne Frontend oder Fantasiedaten.
|
||||
- Projektbezogene Codex-Rollen Scout, Architect, Builder, Verifier und Security Reviewer sind konfiguriert; maximal zwei Unteragenten, nur Builder schreibend.
|
||||
- Im normalen Windows-`PATH` sind Git und VS Code verfügbar. Eine Projektinstallation von Python, `uv`, Ruff, Ollama oder llama.cpp ist noch nicht bestätigt.
|
||||
- Toolchain eingerichtet: uv 0.11.32 und CPython 3.12.13 isoliert unter `D:\Javis-Tools`; Ruff 0.16.0 in der lokalen `.venv`.
|
||||
- Offizielle VS-Code-Erweiterungen installiert: Python 2026.4.0, Pylance 2026.3.1, Python Environments 1.36.0 und Debugpy 2026.6.0.
|
||||
- Windows-PATH und vorhandene Python-Installationen wurden nicht verändert.
|
||||
- Ollama oder llama.cpp sind noch nicht installiert.
|
||||
- Kein Obsidian-, Laptop- oder Rootserverzugriff wurde implementiert.
|
||||
- Keine KI-, Sprach-, Mobil- oder Statusfunktion ist implementiert.
|
||||
|
||||
@@ -77,6 +80,9 @@ Rootserver:
|
||||
- Tokenbewusster Arbeitsablauf festgelegt: gezielte Reads, kurze Ergebnisse, keine unnötigen Agenten oder Plugins.
|
||||
- Werkzeugempfehlung auf `uv`, Microsoft Python/Pylance/Python Environments und Ruff begrenzt.
|
||||
- Langer Handoff einmalig unverändert archiviert und durch diese kompakte aktuelle Zusammenfassung ersetzt.
|
||||
- Handoff-Verdichtung als Commit `e6eb995` nach `origin/main` gepusht.
|
||||
- Branch `feat/core-chat` von diesem Stand erstellt.
|
||||
- uv, CPython 3.12, lokale `.venv`, Ruff, Lockfile und offizielle VS-Code-Python-Erweiterungen eingerichtet.
|
||||
- Obsidian, Ubuntu-Laptop und Rootserver blieben unverändert.
|
||||
|
||||
## Aktuelle Tests
|
||||
@@ -89,15 +95,20 @@ Letzter bestätigter Grundgerüststand:
|
||||
- UTF-8- und interne Markdown-Linkprüfung: bestanden
|
||||
- Secret-Musterprüfung: keine Treffer
|
||||
- Gitignore-Prüfung für lokale Secret-Dateien: bestanden
|
||||
- uv-Lock und `uv sync --dev`: bestanden
|
||||
- Python in `.venv`: 3.12.13
|
||||
- Ruff in `.venv`: 0.16.0
|
||||
|
||||
Für den Textchat existieren noch keine Funktions- oder Modell-Smoke-Tests.
|
||||
|
||||
## Git-Stand
|
||||
|
||||
- aktueller Branch: `feat/core-chat`
|
||||
- stabiler Branch: `main`
|
||||
- Grundgerüstcommit: `6d04171`
|
||||
- letzter Commit vor der Handoff-Verdichtung: `0e82748`
|
||||
- der Commit mit dieser Verdichtung ist über `git log -1 --oneline` zu bestimmen
|
||||
- Handoff-Verdichtung auf `main`: `e6eb995`
|
||||
- aktueller Feature-Commit ist über `git log -1 --oneline` zu bestimmen
|
||||
- `origin` verwendet HTTPS
|
||||
- kein Force-Push und keine umgeschriebene Historie
|
||||
|
||||
@@ -106,12 +117,12 @@ Für den Textchat existieren noch keine Funktions- oder Modell-Smoke-Tests.
|
||||
- `49a1dd3`: erster Gitea-Verbindungstest
|
||||
- `6d04171`: sicheres Javis-Grundgerüst
|
||||
- `0e82748`: Werkzeug-, Token- und Handoff-Regeln
|
||||
- aktuell: einmalige Archivierung und Verdichtung des Handoffs
|
||||
- `e6eb995`: einmalige Archivierung und Verdichtung des Handoffs
|
||||
- aktuell: isolierte Python-Toolchain und reproduzierbare Entwicklungsumgebung
|
||||
|
||||
## Offene Entscheidungen und Fehler
|
||||
|
||||
- endgültiger Produkt-/Repositoryname bleibt offen
|
||||
- konkrete Python-Version und Installation sind noch festzulegen
|
||||
- lokale Modelllaufzeit und erstes Modell sind noch nicht installiert oder benchmarked
|
||||
- genauer späterer Obsidian-Schreibbereich ist nicht freigegeben
|
||||
- endgültiger Secret-Provider ist offen; lokale Klartext-XML wäre nur restriktiv geschützt und Git-ignoriert zulässig
|
||||
@@ -132,12 +143,10 @@ Für den Textchat existieren noch keine Funktions- oder Modell-Smoke-Tests.
|
||||
|
||||
Der genehmigte nächste Meilenstein ist `feat/core-chat`:
|
||||
|
||||
1. von sauberem `main` einen Feature-Branch erstellen
|
||||
2. minimale Python-Toolchain mit `uv`, lokaler `.venv`, Ruff und offiziellen VS-Code-Erweiterungen einrichten
|
||||
3. Ollama und llama.cpp anhand aktueller offizieller Quellen vergleichen und nur eine Laufzeit installieren
|
||||
4. genau ein frei lokal nutzbares Modell unter ungefähr 10 GB herunterladen und auf der RTX 3060 messen
|
||||
5. echten lokalen CLI-Chat mit Provider-Schnittstelle und SQLite-Sitzungen implementieren
|
||||
6. Unit-, Ruff-, Persistenz-, Secret- und echten Modell-Smoke-Test ausführen
|
||||
7. nur bei vollständig erfüllter Abnahme nach `main` mergen
|
||||
1. Ollama als einfachere Windows-Laufzeit installieren; llama.cpp bleibt dokumentierte Alternative
|
||||
2. genau `qwen3:8b` (`Q4_K_M`, 5,2 GB, Apache-2.0) herunterladen und auf der RTX 3060 messen
|
||||
3. echten lokalen CLI-Chat mit Provider-Schnittstelle und SQLite-Sitzungen implementieren
|
||||
4. Unit-, Ruff-, Persistenz-, Secret- und echten Modell-Smoke-Test ausführen
|
||||
5. nur bei vollständig erfüllter Abnahme nach `main` mergen
|
||||
|
||||
Nicht Teil dieses Meilensteins: Obsidian-Integration, Serverzugriff, Sprache, Mobile Client oder Living-Mind-Code.
|
||||
|
||||
@@ -0,0 +1,38 @@
|
||||
# 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 javis chat
|
||||
& 'D:\Javis-Tools\uv\uv.exe' run ruff check .
|
||||
& 'D:\Javis-Tools\uv\uv.exe' run ruff format --check .
|
||||
```
|
||||
|
||||
Die absoluten Pfade sind ausschließlich lokale Entwicklungsdokumentation. Der Anwendungscode darf keine festen Windows-Pfade enthalten.
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
## Ziel
|
||||
|
||||
Phase 1 auf `feat/core-chat`: minimale Python-Toolchain, genau eine lokale Modelllaufzeit und ein echter lokaler CLI-Textchat mit SQLite-Sitzungen.
|
||||
Nächstes Arbeitspaket auf `feat/core-chat`: genau eine lokale Modelllaufzeit und ein echter lokaler CLI-Textchat mit SQLite-Sitzungen.
|
||||
|
||||
## Vor Änderungen erneut prüfen
|
||||
|
||||
@@ -13,8 +13,6 @@ Phase 1 auf `feat/core-chat`: minimale Python-Toolchain, genau eine lokale Model
|
||||
|
||||
## Vorgeschlagener Umfang
|
||||
|
||||
- `uv`, unterstützte stabile Python-Version und offizielle VS-Code-Erweiterungen einrichten
|
||||
- Microsoft Python/Pylance/Python Environments sowie Ruff als minimale Entwicklungswerkzeuge prüfen
|
||||
- Ollama und llama.cpp offiziell vergleichen; nur eine Laufzeit und ein Modell unter ungefähr 10 GB installieren
|
||||
- lokale Konfiguration, Provider-Schnittstelle und SQLite-Sitzungen implementieren
|
||||
- CLI mit neuen, gelisteten und fortsetzbaren Sitzungen
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Projektstatus
|
||||
|
||||
Stand: Dokumentationsverdichtung vor `feat/core-chat`, 30.07.2026.
|
||||
Stand: Toolchain-Arbeitspaket auf `feat/core-chat`, 30.07.2026.
|
||||
|
||||
## Erreicht
|
||||
|
||||
@@ -12,6 +12,9 @@ Stand: Dokumentationsverdichtung vor `feat/core-chat`, 30.07.2026.
|
||||
- projektinterne Codex-Agentensyntax anhand der aktuellen offiziellen Codex-Dokumentation geprüft
|
||||
- phasenbezogene Werkzeug- und Plugin-Empfehlungen sowie tokenbewusste Arbeitsregeln dokumentiert
|
||||
- vollständigen Erst-Handoff archiviert und kompakte laufende Übergabe eingeführt
|
||||
- uv 0.11.32 und CPython 3.12.13 isoliert unter `D:\Javis-Tools` installiert
|
||||
- lokale `.venv`, reproduzierbares `uv.lock` und Ruff 0.16.0 eingerichtet
|
||||
- offizielle VS-Code-Erweiterungen Python, Pylance und Python Environments installiert
|
||||
|
||||
## Nicht implementiert
|
||||
|
||||
@@ -19,10 +22,11 @@ KI, Chat, Provider, Gedächtnis, Obsidian-Adapter, Tools, Serverzugriff, Sprache
|
||||
|
||||
## Git
|
||||
|
||||
- Branch: `main`
|
||||
- Branch: `feat/core-chat`
|
||||
- Grundgerüstcommit: `6d04171`
|
||||
- Der aktuelle Dokumentationscommit ist mit `git log -1` zu ermitteln.
|
||||
- Basis des Feature-Branches: `e6eb995`
|
||||
- Der aktuelle Feature-Commit ist mit `git log -1` zu ermitteln.
|
||||
|
||||
## Bekannte Einschränkung
|
||||
|
||||
Im normalen Windows-`PATH` sind Python, `uv`, Ruff und eine lokale Modelllaufzeit noch nicht bestätigt. Der Textchat ist noch nicht implementiert.
|
||||
Die Toolchain ist nutzbar, ohne den Windows-`PATH` zu verändern. Eine lokale Modelllaufzeit und der Textchat sind noch nicht implementiert.
|
||||
|
||||
Reference in New Issue
Block a user