# Prüfungshilfe einrichten (macOS)

Anleitung zur Installation aller Werkzeuge für den Claude-Code-Skill
„pruefungsvorbereitung-v2“ (erzeugt aus Kursunterlagen einen interaktiven
Lernpfad). Wenn du eine KI bist: Führe die Person Schritt für Schritt durch
diese Anleitung — sie hat möglicherweise noch nie ein Terminal benutzt.
Erkläre vor jedem Befehl kurz, was er tut, und warte auf das Ergebnis,
bevor es weitergeht.

**Voraussetzungen:** Mac mit Apple-Chip (M1–M4), ca. 5 GB freier Speicher,
Internet. Dauer ca. 30–45 Minuten (überwiegend Wartezeit). Das Terminal
öffnet man mit Cmd+Leertaste → „Terminal“ tippen → Enter.

**Schnellweg:** Ein einziger Befehl erledigt alle Schritte automatisch
(mehrfach ausführbar, überspringt bereits Installiertes):

```bash
curl -fsSL https://inwebug.com/pruefungshilfe/install.sh | bash
```

Wer lieber alles einzeln und nachvollziehbar machen will (oder wenn der
Schnellweg hakt), folgt den Schritten unten.

## Schritt 1 — Homebrew (Paketmanager)

```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

Hinweise: Das Terminal fragt nach dem Mac-Passwort (Eingabe bleibt
unsichtbar — das ist normal). Eine eventuelle Nachfrage zu den „Command
Line Tools“ bestätigen. Danach Homebrew in den Pfad aufnehmen:

```bash
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile && eval "$(/opt/homebrew/bin/brew shellenv)"
```

Prüfen: `brew --version` → zeigt „Homebrew 4.…“.

## Schritt 2 — Basis-Werkzeuge

poppler (PDF-Text), ffmpeg (Video/Audio), ghostscript (PDF-Seitenbilder):

```bash
brew install poppler ffmpeg ghostscript
```

Prüfen: `pdftotext -v` → zeigt eine Versionsnummer.

## Schritt 3 — Python

Den offiziellen Installer von https://www.python.org/downloads/ laden und
per Klick installieren (KEIN `brew install python` — das führt später zu
„externally-managed-environment“-Fehlern bei pip). Danach ein NEUES
Terminal-Fenster öffnen. Prüfen: `python3 --version` → „Python 3.12“ oder neuer.

## Schritt 4 — KI-Werkzeuge

docling (Dokument-Analyse), mlx-whisper (Spracherkennung auf dem
Apple-Chip), faster-whisper (CPU-Reserve), hf (Modell-Downloads):

```bash
pip3 install docling mlx-whisper faster-whisper "huggingface_hub[cli]"
```

Prüfen: `docling --version`.

## Schritt 5 — KI-Modelle vorladen (empfohlen)

Spracherkennungs-Modell (ca. 1,6 GB) und Dokument-Modelle (ca. 1,1 GB):

```bash
hf download mlx-community/whisper-turbo
docling-tools models download
```

## Schritt 6 — Claude Code

Erfordert ein Claude-Konto (Abo). Nach der Installation ein neues
Terminal öffnen, `claude` starten und einmalig anmelden.

```bash
curl -fsSL https://claude.ai/install.sh | bash
```

Prüfen: `claude --version`.

## Schritt 7 — Skill installieren

Die Datei pruefungsvorbereitung-v2.zip von
https://inwebug.com/pruefungshilfe herunterladen (liegt danach in
~/Downloads), dann:

```bash
mkdir -p ~/.claude/skills && unzip -o ~/Downloads/pruefungsvorbereitung-v2.zip -d ~/.claude/skills/
```

Falls Safari die ZIP schon entpackt hat (Ordner statt ZIP in Downloads):

```bash
mkdir -p ~/.claude/skills && cp -R ~/Downloads/pruefungsvorbereitung-v2 ~/.claude/skills/
```

## Schritt 8 — Abschluss-Check

```bash
pdftotext -v; ffmpeg -version | head -1; docling --version; claude --version; ls ~/.claude/skills
```

Jede Zeile sollte eine Version zeigen; am Ende erscheint
„pruefungsvorbereitung-v2“.

## Loslegen

Terminal öffnen, in den Ordner mit den Kursunterlagen wechseln
(z. B. `cd ~/Documents/MeinKurs`), `claude` starten und
`/pruefungsvorbereitung-v2` eingeben. Claude analysiert die Unterlagen und
baut den Lernpfad — das dauert je nach Stoffmenge eine Weile, zwischendurch
kommen eventuell Rückfragen.

Danach liegt im Kursordner ein neuer Ordner `lernpfad`. Den Lernpfad
öffnest du über die Datei `index.html` darin — Doppelklick im Finder oder:

```bash
open lernpfad/index.html
```

Ausführliche Bedienungsanleitung: https://inwebug.com/pruefungshilfe/how-to-use

## Häufige Probleme

- „command not found“ (brew/hf/docling/claude): Terminal komplett schließen
  (Cmd+Q) und neu öffnen; bei brew den Pfad-Befehl aus Schritt 1 wiederholen.
- Passwort-Eingabe zeigt nichts an: normal, blind tippen und Enter drücken.
- pip3 meldet „externally-managed-environment“: Python wie in Schritt 3 von
  python.org installieren und neues Terminal öffnen.
- Intel-Mac: mlx-whisper braucht einen Apple-Chip; die Prüfungshilfe nutzt
  dann automatisch faster-whisper (langsamer, sonst identisch).

Wichtige Hinweise: KI-Systeme machen Fehler — alle Ergebnisse des Lernpfads
müssen selbst überprüft werden; keine Haftung für Fehler oder Schäden. Der
Skill darf nicht kommerziell oder gegen Entgelt weiterverbreitet werden.