Klausur-Werkbank · Anleitung

01 · Überblick

Was das Programm tut.

Du legst pro Klausur eine Sammlung an (Titel, Fach, Kurs, Datum).
Pro Schüler lädst du Foto(s) der handgeschriebenen Klausur hoch.
Du lässt das Bild von einem KI-Werkzeug deiner Wahl transkribieren (telli, fobizz, ChatGPT, Claude). Das Programm hilft dir, das Bild und einen passenden Prompt mit einem Klick in die Zwischenablage zu legen.
Du fügst das Transkript zurück in den Editor ein, korrigierst, speicherst.
Alle Daten liegen lokal in einem Ordner klausuren/ neben dem Programm.

Browser-Empfehlung

Die Klausur-Werkbank läuft in jedem aktuellen Browser. Erfahrungsgemäss am reibungslosesten in Chrome: insbesondere das Kopieren von Bildern in die Zwischenablage ist dort am robustesten. Auf Mac startet das Programm Safari als Standard; bei Problemen einfach http://127.0.0.1:8765 in Chrome öffnen.

02 · Setup Mac

Erstinstallation Mac.

Schritt 0: unbedingt zuerst

Den entpackten Ordner nicht in Downloads, Dokumente oder Schreibtisch liegen lassen. macOS Sequoia (15+) blockiert dort den Zugriff für das Einrichtungs-Programm (uv).

Stattdessen den ganzen Ordner ins Hauptverzeichnis ziehen; im Finder links in der Seitenleiste der Eintrag mit dem Haus-Symbol und deinem Benutzernamen.

ZIP entpacken (Doppelklick reicht).
Den entpackten Ordner aus Downloads ins Hauptverzeichnis ziehen (Drag & Drop in der Finder-Seitenleiste).
In den verschobenen Ordner gehen.
Doppelklick auf Klausur-Werkbank starten.command.
Es erscheint eine Sicherheitswarnung: „Apple could not verify ... is free of malware" mit den Knöpfen Move to Trash und Done. Das ist macOS-Standardverhalten für alle Skripte ausserhalb des App Stores.
Knopf Done anklicken (nicht Move to Trash).
Apfel-Menü oben links, dann Systemeinstellungen ... öffnen.
Links Datenschutz & Sicherheit wählen.
Nach unten scrollen bis zum Abschnitt Sicherheit; dort steht: „Klausur-Werkbank starten.command wurde blockiert ...". Daneben Trotzdem öffnen anklicken.
macOS fragt nach Passwort oder Touch ID; bestätigen.
Die ursprüngliche Warnung erscheint nochmal, diesmal mit dem zusätzlichen Knopf Öffnen. Anklicken.
Ein Terminal-Fenster öffnet sich, das Programm startet. Beim allerersten Start lädt es ca. 100 MB an Python-Komponenten herunter (1 bis 2 Minuten). Der Browser öffnet sich automatisch unter http://127.0.0.1:8765.

Hinweis

Diese Freigabe ist einmalig. Ab jetzt startet das Programm bei jedem Doppelklick ohne Warnung.

Tipp

Klausur-Werkbank starten.command ins Dock ziehen (rechte Seite, neben dem Papierkorb); dann genügt ein Klick.

Schneller Alternativweg (Terminal)

Wer Terminal kennt, spart sich den Systemeinstellungen-Umweg:

Programme/Dienstprogramme/Terminal öffnen (oder Cmd+Leertaste, „Terminal" eintippen).
xattr -cr eintippen (mit Leerzeichen am Ende, nicht Enter).
Den entpackten Ordner aus dem Finder ins Terminal-Fenster ziehen (Pfad wird automatisch eingefügt).
Enter drücken.
Doppelklick auf Klausur-Werkbank starten.command funktioniert nun ohne Warnung.

Beenden: Strg+C im Terminal-Fenster drücken, dann das Fenster schliessen.

03 · Setup Windows

Erstinstallation Windows.

ZIP entpacken (Rechtsklick, dann Alle extrahieren).
In den entpackten Ordner gehen.
Doppelklick auf start.bat.
SmartScreen-Filter meldet sich („Der Computer wurde durch Windows geschützt"): Weitere Informationen, dann Trotzdem ausführen.
Konsolen-Fenster öffnet sich. Beim allerersten Start lädt es ca. 100 MB an Python-Komponenten herunter (1 bis 2 Minuten).
Browser öffnet sich automatisch unter http://127.0.0.1:8765.

Beenden: Strg+C im Konsolen-Fenster drücken, dann das Fenster schliessen.

04 · Workflow

Arbeitsablauf.

1. Klausur anlegen

Knopf + Neue Klausur oben rechts.
Eintragen: Titel (z. B. „Klausur Englisch Q1: Adichie"), Fach, Kurs, Datum.
Anlegen. Die Klausur erscheint links in der Seitenleiste.

2. Schüler hinzufügen

Klausur in der Seitenleiste auswählen.
Knopf + Schüler im Klausur-Kopf.
Es entsteht ein Schülereintrag mit anonymer ID (z. B. S-001).
Optional: Klartextnamen eintragen. Bleibt nur lokal in einer Datei meta.json; wird nie an externe Dienste geschickt.

3. Bild(er) hochladen

Schüler in der mittleren Spalte auswählen.
Knopf Bilder hinzufügen über dem Bildbereich.
Foto/Scan auswählen. Mehrere Seiten pro Schüler sind möglich.
Mit « Seite / Seite » blättern. Mit −/100 %/+ zoomen, mit ↺/↻ drehen.

4. Transkribieren (Bridge-Modus)

Standardmodus: du nutzt ein KI-Werkzeug deiner Wahl.

Knopf Bild kopieren: aktuelles Bild liegt in der Zwischenablage.
Knopf Prompt kopieren: vorbereiteter Transkriptions-Prompt liegt in der Zwischenablage.
Wechsel zu telli / fobizz / ChatGPT / Claude:
- Bild ins Chat-Fenster einfügen (Cmd+V bzw. Strg+V)
- Prompt einfügen (zweites Einfügen)
- Antwort abwarten
Antwort kopieren, in der Klausur-Werkbank in den rechten Texteditor einfügen.
Speichern mit Cmd+S bzw. Strg+S.
Nach Korrektur: Knopf Als korrigiert markieren.

05 · Optional

API-Modus (optional).

Wer einen API-Key hat, kann die Klausur-Werkbank direkt mit dem KI-Anbieter sprechen lassen. Vorteil: das manuelle Kopieren von Bild und Prompt in telli, fobizz, ChatGPT oder Claude entfällt, ein Klick reicht. Nachteil: pro Seite fallen ein paar Cent an, und die Bilder gehen an einen externen Dienst (im Bridge-Modus ist das identisch, nur eben über den Browser).

Welche Anbieter funktionieren

Mistral (Frankreich, EU-gehostet, datenschutzfreundlich, empfohlen). Es gibt zwei Modi: OCR für klassische Texterkennung, Pixtral als Vision-Modell.
OpenAI (USA). Nutzt GPT-4o mit Bildverständnis.
Anthropic (USA). Nutzt Claude mit Bildverständnis.
Ollama (lokal). Läuft auf deinem Rechner, kostenlos, braucht aber einen leistungsfähigen Computer und ein vorab heruntergeladenes Vision-Modell.

Empfehlung

Für die Schule ist Mistral OCR die naheliegende Wahl: EU-gehostet (DSGVO-konform abrechenbar), günstig (deutlich unter einem Cent pro Seite, Stand 2026), und für Handschrift erfahrungsgemäss zuverlässig.

So bekommst du einen API-Key

Mistral. Auf console.mistral.ai ein Konto anlegen, im Menü links API Keys, Create new key. Vor dem ersten Aufruf muss eine Zahlungsmethode hinterlegt sein (im Menü Billing); Pay-as-you-go, ein aufgeladenes Guthaben von 5–10 Euro reicht für mehrere Klassenarbeiten. Den Key sofort kopieren und sicher ablegen, er wird nur einmal angezeigt.

OpenAI. Auf platform.openai.com einloggen, oben rechts auf das Profil, API Keys, Create new secret key. Zahlungsmethode unter Billing hinterlegen.

Anthropic. Auf console.anthropic.com einloggen, Settings, API Keys, Create Key. Auch hier vorab Guthaben aufladen oder Zahlungsmethode hinterlegen.

Ollama. Auf ollama.com herunterladen, installieren, dann im Terminal das gewünschte Modell ziehen (z. B. ollama pull qwen2.5-vl:7b). Kein Key nötig, dafür eigene Hardware.

Datenschutz: Was zu beachten ist

Im API-Modus werden Schüler-Bilder an den jeweiligen Anbieter gesendet. Die Bilder enthalten Handschrift, oft auch sichtbare Namen oder Kursangaben auf dem Klausurblatt. Für die Verarbeitung personenbezogener Daten brauchst du in der Regel einen Auftragsverarbeitungsvertrag (AVV). Mistral bietet einen DSGVO-konformen AVV mit EU-Hosting an, was im Schulkontext die saubere Wahl ist. Bei US-Anbietern (OpenAI, Anthropic) immer mit der Schulleitung bzw. dem Datenschutzbeauftragten klären. Ollama sendet nichts nach aussen, ist daher unkritisch.

Den API-Key in der Werkbank hinterlegen

Im Programmordner die Datei .env.example finden. Sie ist versteckt, weil sie mit einem Punkt beginnt. Sichtbar machen:
- Mac: im Finder den Programmordner öffnen, dann Cmd+Shift+. drücken. Versteckte Dateien werden eingeblendet.
- Windows: im Explorer den Reiter Ansicht, dann Einblenden, dann Häkchen bei Ausgeblendete Elemente.
.env.example duplizieren (Rechtsklick, Duplizieren bzw. Kopieren & Einfügen) und die Kopie zu .env umbenennen (nur die vier Zeichen .env, ohne .example).
.env öffnen:
- Mac: Rechtsklick, Öffnen mit, TextEdit.
- Windows: Rechtsklick, Öffnen mit, Editor (Notepad).
Den Key bei der passenden Zeile eintragen, direkt hinter das Gleichheitszeichen, ohne Anführungszeichen und ohne Leerzeichen:
- Mistral: MISTRAL_API_KEY=dein-key-hier
- OpenAI: OPENAI_API_KEY=dein-key-hier
- Anthropic: ANTHROPIC_API_KEY=dein-key-hier
Bei der Zeile TRANSKRIPTIONS_PROVIDER=keiner den passenden Wert eintragen:
- mistral_ocr für Mistrals klassischen OCR-Modus (empfohlen für Handschrift)
- mistral_pixtral für Mistrals Vision-Modell
- openai für OpenAI
- anthropic für Anthropic
- ollama für ein lokales Ollama-Modell
Datei speichern (Cmd+S bzw. Strg+S) und das Editor-Fenster schliessen.
Die Klausur-Werkbank beenden (Strg+C im Terminal/Konsolen-Fenster) und neu starten.
Im Editor erscheint nun der Knopf Mit API transkribieren. Klick, kurz warten, das Transkript wird automatisch eingefügt.

Wenn der Knopf nicht erscheint

Häufigste Ursachen: die Datei heisst .env.txt statt .env (TextEdit hängt manchmal automatisch .txt an, das muss raus); der Provider-Wert ist verschrieben (es muss exakt mistral_ocr heissen, nicht mistralOcr oder mistral-ocr); oder das Programm wurde nach dem Speichern nicht neu gestartet.

Bridge-Modus bleibt verfügbar

Auch mit API-Key sind die Knöpfe Bild kopieren und Prompt kopieren weiterhin nutzbar. Für einzelne Schüler, bei denen die KI an der Handschrift scheitert, kannst du jederzeit auf den manuellen Workflow zurückfallen.

06 · Tastatur

Tastenkürzel.

Aktion	Mac	Windows
Speichern	`Cmd`+`S`	`Strg`+`S`
Nächster Schüler	`Cmd`+`→`	`Strg`+`→`
Vorheriger Schüler	`Cmd`+`←`	`Strg`+`←`
Hilfe schliessen	`Esc`

07 · Daten

Datenschutz.

Alle Daten liegen lokal im Unterordner klausuren/ des Programmordners.
Klartextnamen der Schüler bleiben immer nur lokal in meta.json.
Kein Versand an externe Server, ausser du schickst Bilder bewusst an ein KI-Werkzeug (Bridge-Modus) oder nutzt den optionalen API-Modus.
Empfehlung: Programmordner liegt im persönlichen Bereich, nicht in einem geteilten Cloud-Ordner.
Nach Notenkonferenz: Klausur-Ordner klausuren/<klausur_id>/ einfach löschen, fertig.

08 · Troubleshooting

Bei Problemen.

Klausuren werden nicht geladen / leere Liste

Du hast vermutlich frontend/index.html direkt im Browser geöffnet (Adresse beginnt mit file://). Das funktioniert nicht.

Lösung: Programm immer über Klausur-Werkbank starten.command (Mac) bzw. start.bat (Windows) starten. Adresszeile muss http://127.0.0.1:8765 sein.

„Bild kopieren" funktioniert nicht

Browser braucht Erlaubnis für Zwischenablage. Beim ersten Mal fragt der Browser nach; Erlauben anklicken.

Wenn das Bild-Kopieren auch danach fehlschlägt (typische Meldung: „The request is not allowed by the user agent ..."): einmal http://127.0.0.1:8765 in Chrome öffnen. Chrome ist die zuverlässigste Wahl für die Bild-Zwischenablage; ältere Safari-Versionen können hier zicken.

Mac: „Current directory does not exist" beim Start

Der Ordner liegt vermutlich in Downloads, Dokumente oder Schreibtisch. Ordner ins Hauptverzeichnis verschieben (siehe Erstinstallation Mac, Schritt 0).

Mac: „Apple could not verify ..." beim ersten Start

Standardverhalten von macOS 15 für unsignierte Skripte. Siehe Erstinstallation Mac für den einmaligen Freigabe-Schritt über Systemeinstellungen, Datenschutz & Sicherheit.

Terminal-Fenster zeigt rote Fehlermeldung

Bei Address already in use: Das Programm läuft schon (anderes Terminal-Fenster oder Browser-Tab). Browser öffnen, http://127.0.0.1:8765 aufrufen.

Bei anderen Fehlern: Screenshot machen, Bezugsweg über tools.languageteachercrew.com (siehe Impressum).

09 · Updates

Updates installieren.

Wenn eine neue Version verteilt wird:

Eigene Klausuren sichern: Ordner klausuren/ aus dem alten Programmordner an einen sicheren Ort kopieren.
Neue ZIP entpacken und ins Hauptverzeichnis verschieben.
Den gesicherten Ordner klausuren/ in den neuen Programmordner hineinkopieren.
Programm starten wie gewohnt.

10 · Kontakt

Kontakt.

Bei Fragen, Fehlern oder Verbesserungsvorschlägen siehe Impressum auf tools.languageteachercrew.com.

Diese Anleitung wird bei jedem Update mit ausgeliefert (ANLEITUNG.md / ANLEITUNG.html im Programmordner).

Anleitung.