Anleitung.

Was das Programm tut.

1. Du legst pro Klausur eine Sammlung an (Titel, Fach, Kurs, Datum).
2. Pro Schüler lädst du Foto(s) der handgeschriebenen Klausur hoch.
3. Du lässt das Bild von einem KI-Werkzeug deiner Wahl transkribieren (fobizz, ChatGPT, Claude). Das Programm hilft dir, das Bild und einen passenden Prompt mit einem Klick in die Zwischenablage zu legen.
4. Du fügst das Transkript zurück in den Editor ein, korrigierst, speicherst.
5. Optional: Du exportierst alle Transkripte einer Klausur als JSON-Bundle und öffnest es direkt im Feedback-Tool. Wenn vorher ein Planer-Build aus dem KA-Builder angedockt wurde, enthält das Bundle auch Aufgaben, Kompetenzen und Bewertung.
6. Alle Daten liegen lokal in einem Ordner klausuren/ neben dem Programm.

Erstinstallation Mac.

1. ZIP entpacken (Doppelklick reicht).
2. Den entpackten Ordner aus Downloads ins Hauptverzeichnis ziehen (Drag & Drop in der Finder-Seitenleiste).
3. In den verschobenen Ordner gehen.
4. Doppelklick auf Klausur-Werkbank starten.command.
5. 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.
6. Knopf Done anklicken (nicht Move to Trash).
7. Apfel-Menü oben links, dann Systemeinstellungen ... öffnen.
8. Links Datenschutz & Sicherheit wählen.
9. Nach unten scrollen bis zum Abschnitt Sicherheit; dort steht: „Klausur-Werkbank starten.command wurde blockiert ...". Daneben Trotzdem öffnen anklicken.
10. macOS fragt nach Passwort oder Touch ID; bestätigen.
11. Die ursprüngliche Warnung erscheint nochmal, diesmal mit dem zusätzlichen Knopf Öffnen. Anklicken.
12. 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.

Schneller Alternativweg (Terminal)

Wer Terminal kennt, spart sich den Systemeinstellungen-Umweg:

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

Beenden: Ctrl+C im Terminal-Fenster drücken (auf der Mac-Tastatur die control-Taste, nicht cmd), dann das Fenster schliessen.

Erstinstallation Windows.

1. ZIP entpacken (Rechtsklick, dann Alle extrahieren).
2. In den entpackten Ordner gehen.
3. Doppelklick auf Klausur-Werkbank starten.bat.
   Anmerkung zur Dateianzeige

   Windows blendet die Endung .bat standardmässig aus. Im Explorer steht deshalb meist nur Klausur-Werkbank starten (ohne .bat). Es ist die Datei mit dem Zahnrad- oder Konsolen-Symbol und dem Typ Windows-Batch-Datei.

4. Sicherheitswarnung von Windows SmartScreen: „Der Computer wurde durch Windows geschützt", mit prominentem Knopf Nicht ausführen.
   • Auf den kleinen Link „Weitere Informationen" klicken (steht direkt unter dem Warntext, wird leicht übersehen).
   • Erst dann erscheint der Knopf Trotzdem ausführen. Anklicken.
5. Konsolen-Fenster öffnet sich. Beim allerersten Start lädt es ca. 100 MB an Python-Komponenten herunter (1 bis 2 Minuten).
6. Browser öffnet sich automatisch unter http://127.0.0.1:8765.

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

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.

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

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 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.

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.

Den API-Key in der Werkbank hinterlegen

1. 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.
2. .env.example duplizieren (Rechtsklick, Duplizieren bzw. Kopieren & Einfügen) und die Kopie zu .env umbenennen (nur die vier Zeichen .env, ohne .example).
3. .env öffnen:
   • Mac: Rechtsklick, Öffnen mit, TextEdit.
   • Windows: Rechtsklick, Öffnen mit, Editor (Notepad).
4. 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
5. Bei der Zeile TRANSKRIPTIONS_PROVIDER=keiner den passenden Wert eintragen:
   • mistral_pixtral für Mistrals Vision-Modell (empfohlen für Handschrift, behält Zeilenumbrüche)
   • mistral_ocr für Mistrals klassischen OCR-Modus (günstiger, fasst Zeilen zu Absätzen zusammen)
   • openai für OpenAI
   • anthropic für Anthropic
   • ollama für ein lokales Ollama-Modell
6. Datei speichern (Cmd+S bzw. Strg+S) und das Editor-Fenster schliessen.
7. Die Klausur-Werkbank beenden: im Terminal (Mac) Ctrl+C bzw. im Konsolen-Fenster (Windows) Strg+C. Danach neu starten.
8. Im Editor erscheint nun der Knopf Mit API transkribieren. Klick, kurz warten, das Transkript wird automatisch eingefügt.

Übergabe ans Feedback-Tool.

Wenn alle Transkripte einer Klausur erfasst sind, kann die Werkbank sie als einzelne JSON-Datei in das webbasierte Feedback-Tool (ka-feedback.html) übergeben. So entsteht ohne Copy-and-Paste eine fertig vorbereitete Korrekturrunde, in der pro Schüler:in eine Zeile mit eingespieltem Text liegt.

1. Optional: Planer-Build andocken

Im KA-Builder die Klassenarbeit fertigstellen und über Build als JSON speichern. In der Werkbank in der Klausur-Kopfzeile auf Planer-Build anhängen klicken, die JSON-Datei wählen. Eine grüne Statuszeile zeigt anschliessend Titel, Sprache und Aufgabenzahl an. Über Build lösen lässt sich der Build wieder entfernen, ohne dass die Transkripte angetastet werden.

2. Schüler:innen auswählen und exportieren

• Knopf Für Feedback-Tool exportieren in der Kopfzeile öffnet einen Auswahl-Dialog.
• Vorgewählt sind alle, die als korrigiert markiert sind. Schnellfilter über den kleinen Knöpfen Alle, Keine, Nur korrigierte, Alle mit Text.
• Pro Zeile zeigt eine Mini-Statusangabe an, ob Text vorhanden und ob die Schülerin als korrigiert markiert ist.
• JSON herunterladen liefert die Datei feedback-bundle_<klausur_id>.json.

3. Im Feedback-Tool öffnen

1. In ka-feedback.html Knopf Build / Werkbank / JSON / ZIP laden.
2. Die Bundle-Datei wählen. Im Feedback-Tool sind alle Schüler:innen sofort als Korrekturzeile angelegt, der Schülertext ist eingetragen, Aufgaben/Bewertung/EWH stammen aus dem Build (sofern angedockt).
3. Ab hier kann die Korrektur wie gewohnt mit dem Feedback-Tool laufen: pro Aufgabe Rückmeldung, Bewertung, Überarbeitungsauftrag.

Tastenkürzel.

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.

Bei Problemen.

Updates installieren.

Wenn eine neue Version verteilt wird:

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

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).