Sina Kashani
Fallstudie · Offline-Tool

redactor

Ein Offline-Tool, das Geheimnisse aus Texten entfernt, bevor ich sie in einen KI-Assistenten einfüge.

Problem

Wenn ich einen KI-Assistenten um Hilfe bitte, füge ich oft Logs, Konfigurationsdateien oder Terminalausgaben ein. Darin können API-Schlüssel, Passwörter oder Tokens stehen. Ich wollte eine schnelle Möglichkeit, den Text vorher zu bereinigen, ohne ihn an einen weiteren Onlinedienst zu schicken.

Was ich gebaut habe

redactor ist ein Kommandozeilen-Tool mit einer kleinen lokalen Webseite. Man fügt Text ein und bekommt denselben Text zurück, in dem Geheimnisse durch Platzhalter wie [REDACTED: OpenAI API Key] ersetzt sind. Die Platzhalter halten den Text lesbar, sodass der Assistent ihn weiterhin versteht.

Es gibt 25 Detektoren für bekannte Schlüsselformate (Cloud-Anbieter, Versionsverwaltung, Zahlungsdienste, private Schlüssel, Verbindungsstrings) und zwei heuristische Detektoren für Geheimnisse ohne festes Format. Personenbezogene Daten wie E-Mail-Adressen und Telefonnummern lassen sich in der Konfiguration einschalten. Das Tool kann außerdem einen Ordner scannen, Commits über einen Git-Hook blockieren, die Zwischenablage bereinigen und ein Audit-Log ohne die Originalwerte schreiben.

Ein optionaler zweiter Durchlauf nutzt ein lokales Sprachmodell über Ollama. Er schwärzt nur Text, der tatsächlich in der Eingabe vorkommt. Läuft das Modell nicht, funktioniert das Tool trotzdem.

Mein Anteil

Ich habe das gesamte Projekt allein entworfen und geschrieben.

Ergebnis

Das Tool läuft vollständig offline und hat keine Laufzeitabhängigkeiten. Es hat eine Testsuite und CI für Python 3.11 bis 3.13. Ich nutze es selbst, bevor ich Text teile.

Nächste Schritte

Eine Editor-Erweiterung, eine bessere Erkennung personenbezogener Daten und Regelpakete pro Projekt.