Installationsanleitung

Wittgenstein bietet verschiedene interne Python-Pakete (wie fastapi-openai, llm-router, observability und pipelines), die in unserem privaten Nexus-Repository gehostet werden.

Voraussetzungen

Bevor Sie die Bibliotheken installieren, stellen Sie sicher, dass Sie in Ihrer Umgebung Folgendes konfiguriert haben: 1. Python 3.11+ 2. Paketmanager pip oder uv installiert 3. Authentifizierungsdaten für Nexus (NEXUS_USER und NEXUS_PASS)

Nexus Index Konfigurieren

Um Pakete aus unserer privaten Nexus-PyPI-Registry zu installieren, müssen Sie Ihrem Installationsbefehl die Nexus-URL --extra-index-url hinzufügen.

$ export NEXUS_USER="ihr_benutzername"
$ export NEXUS_PASS="ihr_passwort"
$ pip install wittgenstein-observability wittgenstein-pipelines \
  --extra-index-url https://${NEXUS_USER}:${NEXUS_PASS}@devops.buildaz.io/nexus/repository/pypi-internal/simple
---> 100%
Successfully installed wittgenstein-observability wittgenstein-pipelines

Tipp für UV-Benutzer

Wenn Sie uv von Astral für blitzschnelle Auflösungen verwenden, ist die Syntax identisch. Ersetzen Sie einfach pip install durch uv pip install.

Permanente Konfiguration

Für eine dauerhaftere Einrichtung können Sie das Nexus-Repository zu Ihrer pip.conf (oder uv.toml) hinzufügen:

~/.config/pip/pip.conf

[global]
extra-index-url = https://ci:****@devops.buildaz.io/nexus/repository/pypi-internal/simple

Die Sicherheitsbibliotheken installieren

Die Sicherheitsbibliotheken werden auf dieselbe Weise ausgeliefert: das Python-Backend-Toolkit über die Nexus-PyPI-Registry und der Browser-Client über npm.

$ uv pip install wittgenstein-oidc-backend \
  --extra-index-url https://${NEXUS_USER}:${NEXUS_PASS}@devops.buildaz.io/nexus/repository/pypi-internal/simple
---> 100%
Installed 1 package in 42ms
$ npm install @wittgenstein/oidc-client
---> 100%
added 1 package in 3s

Installation prüfen

$ python -c "import wittgenstein_oidc_backend as m; print(sorted(m.__all__)[:3])"
['JwksClient', 'OidcMiddleware', 'OidcMode']
$ python -c "from wittgenstein_oidc_backend import create_oidc_bff_router, has_role; print('ok')"
ok

Diese Dokumentation lokal bauen

make build erstellt mit uv ein Virtualenv, installiert die Site-Requirements, erzeugt die SDK-Referenz aus wittgenstein-core (gecacht) und führt mkdocs build aus. Verwenden Sie .venv/bin/mkdocs serve für eine Live-Vorschau.

$ make build && .venv/bin/mkdocs serve
[sync-core-api] core@8f7bfa93: 21 libs, 0 to regenerate — everything served from cache
INFO    -  Documentation built in 13.80 seconds
INFO    -  Serving on http://127.0.0.1:8000/