Variante A: ZIP-Download
Im GitHub-Repo auf Code -> Download ZIP klicken, ZIP entpacken und den entpackten Ordner im Terminal oeffnen.
Didaktische Schrittfolge
Installation fuer Laien, Schueler, Studierende und fachfremde Nutzer. Mit klaren Schritten vom Download bis zum ersten Start.
Diese Seite priorisiert einfache, sichere Schritte. Wenn du technisch tiefer arbeiten willst (Tests, reproduzierbare Build-Pfade), nutze die Profi-Anleitung.
Schritt 1
Repository holen (Link, Download, Entpacken)
Variante B: Git Clone
git clone https://github.com/vfi64/wrapper.git
Dann in den Ordner wechseln.
Schritt 2-4
Voraussetzungen, Installation, Start
| Thema | Anleitung |
|---|---|
| Voraussetzungen | Python 3.10 oder neuer, Terminalzugang, Internet fuer Paketinstallation und Provider-APIs. |
| Installation | bash scripts/setup_venv.sh |
| Virtuelle Umgebung aktivieren | source .venc/bin/activate |
| Wrapper starten | python Comm-SCI-Control-App.py |
| Optional: Grundtest | python -m pytest -q tests |
Schritt 5
API-Keys beschaffen und eintragen
| Provider | Key erstellen | Kosten/Pricing |
|---|---|---|
| Gemini | aistudio.google.com/apikey | ai.google.dev/pricing |
| OpenRouter | openrouter.ai/keys | openrouter.ai/models |
| Hugging Face | huggingface.co/settings/tokens | huggingface.co/pricing |
API-Keys koennen ueber Umgebungsvariablen oder lokal in
Config/Comm-SCI-API-Keys.json genutzt werden.
Fuer Team-/Produktivumgebungen sind Umgebungsvariablen die bessere Wahl.
| Speichermodus | Bedeutung im Wrapper |
|---|---|
api_key_plain |
Unverschluesselt lokal gespeichert. Kein Passphrase-Dialog beim Start oder Provider-Wechsel. |
api_key_enc |
Verschluesselt lokal gespeichert. Passphrase-Dialog wird angezeigt, sobald der jeweilige Provider genutzt wird. |
API-Keys im Programm pflegen: Panelbereich Provider & LLM oeffnen, API-Key klicken, Provider waehlen, speichern.
Wichtig
Geheimhaltung der API-Keys und Kostenkontrolle
Key-Schutz
Niemals API-Keys in Screenshots, Mails, Chats, Issues oder oeffentliche Repos kopieren.
Kostenhinweis
Modelle koennen pro Anfrage Kosten verursachen. Vor Einsatz immer Preis- und Limitseiten des Providers pruefen.
Bei Leak
Key sofort im Provider-Portal widerrufen, neu erzeugen und lokale Konfiguration aktualisieren.