KI-Assistent für Sparx Enterprise Architect – sprechen Sie mit Ihrem Modell

Ja. Loonar Compass ist Freeware: kostenlos für jeden Zweck, auch beruflich und kommerziell, auf beliebig vielen Computern. Sie dürfen die Anwendung auch weitergeben – kostenlos, vollständig, unverändert und zusammen mit den Dateien LICENSE und THIRD-PARTY-NOTICES.

Der Quellcode ist auf GitHub öffentlich, sodass Sie genau sehen, was die Anwendung mit Ihrem Modell macht. Er ist einsehbar (Source-available), aber nicht Open Source: Nicht erlaubt sind Änderungen an der Anwendung und abgeleitete Werke sowie Verkauf oder Vermietung. Lizenz lesen.

Die Anwendung selbst ist kostenlos. Der Assistent arbeitet mit Ihrem eigenen Claude-API-Schlüssel aus der Anthropic Console; Anthropic rechnet die Nutzung mit dem Konto ab, zu dem der Schlüssel gehört – nach Verbrauch, also nach der Textmenge, die das Modell liest und schreibt. Aktuelle Preise finden Sie auf der Preisseite von Anthropic.

Das Modell ist immer Claude Haiku 5.5 (claude-haiku-5-5) und keine Einstellung. „Max. Tokens“ (standardmäßig 10.000) begrenzt nur die Länge einer einzelnen Antwort: Sie zahlen für den tatsächlich erzeugten Text.

Unter Windows 10 und Windows 11, jeweils 64 Bit. Es ist eine native Windows-Desktopanwendung und arbeitet mit Enterprise Architect zusammen, das auf demselben Computer installiert ist.

• Enterprise Architect auf demselben Computer, mit gültiger Lizenz. Zum Speichern startet der Assistent es im Hintergrund, wo es einen Lizenzplatz belegt; nach 10 Minuten ohne Arbeit und beim Schließen der Anwendung wird es wieder beendet. Ist die Modelldatei in Ihrem EA geöffnet, laufen die Änderungen stattdessen über Ihr Fenster – ein zweites EA öffnet nie dieselbe Datei.
• Das Modell als EA-Projektdatei .qea oder .qeax – in den Einstellungen „2. Modell“ → „EA-Datei (.qea, .qeax)“ und der Pfad unter „Modelldatei“, ohne Datenbankserver, Konto und Passwort – oder in einer PostgreSQL-Datenbank, die Ihr Computer erreicht (Server, Port, Datenbankname, Konto). Eine .qea-Datei ist für eine Person gedacht, .qeax für ein kleines Team, das die Datei gemeinsam nutzt (Sparx empfiehlt es für weniger als 5 Benutzer). Ältere Dateiformate (.eap, .eapx, .feap) und Repositorys in anderen Datenbanken werden nicht unterstützt; eine .eap/.eapx-Datei überführt Enterprise Architect per Projekttransfer in eine .qea-Datei (Settings → Model → Transfer → Full Project Transfer).
• Für ein Modell in einer Datenbank: aktivierte Benutzersicherheit (Settings → Security → Enable Security) im Modus „Require User Lock to Edit“. In einer Modelldatei ist die Sicherheit optional – ohne sie braucht der Assistent kein EA-Konto.
• Bei aktivierter Sicherheit: ein EA-Benutzerkonto für den Assistenten mit Passwort und Bearbeitungsrechten – am besten ein eigenes, damit sich seine Änderungen und Sperren leicht von Ihren unterscheiden lassen.

Die Anwendung prüft weder Version noch Edition von EA. Entscheidend ist, dass Ihr Enterprise Architect dieses Modell öffnen kann: die Datei oder das Datenbank-Repository mit aktivierter Sicherheit.

Nein. Standardmäßig („Nur für mich“) installiert das Installationsprogramm Loonar Compass nur für Ihr Benutzerkonto, unter %LOCALAPPDATA%\Programs\Loonar Compass, und braucht dafür keine Administratorrechte. Wählen Sie stattdessen „Für alle Benutzer dieses Computers“ (unter C:\Program Files\Loonar Compass), fragt das Installationsprogramm nach Administratorrechten.

Die Anwendung selbst läuft immer als normaler Benutzer, und jeder Benutzer hat eigene Einstellungen und Unterhaltungen. Bestätigt jemand anderes eine Installation für alle Benutzer mit einem Administratorkonto, geben Sie Ihre Konfiguration später in der Anwendung ein (Einstellungen), nicht im Installationsprogramm – sonst landet sie im Profil des Administrators.

Weil das Installationsprogramm der Version 0.4 noch nicht digital signiert ist (mit einem Codesignaturzertifikat) und Windows den Herausgeber daher nicht kennt. Microsoft Defender SmartScreen kann deshalb beim Start „Der Computer wurde durch Windows geschützt“ melden, und Ihr Browser kann warnen, dass die Datei selten heruntergeladen wird. Die Standardinstallation für Ihr Benutzerkonto braucht keine Administratorrechte, daher erscheint keine Administratorabfrage; nur die Installation für alle Benutzer fragt danach – und zeigt den Herausgeber als unbekannt an. Ein signiertes Installationsprogramm ist geplant und sollte bald folgen. Bis dahin:

• Laden Sie das Installationsprogramm nur von loonar.eu oder aus den Releases des Projekts auf GitHub über HTTPS herunter.
• Vergleichen Sie seine Prüfsumme mit der SHA-256 neben der Download-Schaltfläche – in PowerShell: Get-FileHash .\LoonarCompass-Setup-0.4.exe.
• Klicken Sie im SmartScreen-Fenster auf „Weitere Informationen“ und dann auf „Trotzdem ausführen“.

Unter Windows 11 mit aktivierter intelligenter App-Steuerung (Smart App Control) werden nicht signierte Anwendungen blockiert und lassen sich so nicht starten – warten Sie in diesem Fall bitte auf die signierte Version.

Er speichert nur, was Sie zulassen, und nur so, wie Enterprise Architect es erlaubt:

• Freigabemodi: ask – Sie geben jede Speicherung frei; plan – eine Freigabe pro Antwort; auto – ohne Rückfrage, für Testmodelle. Veröffentlichungen in Confluence brauchen immer Ihre Freigabe, und die Anfrage sagt ausdrücklich, wenn eine bestehende Seite ersetzt wird.
• Schreiben nur über EA: Die Datenbank wird in einer schreibgeschützten Sitzung gelesen, eine Modelldatei schreibgeschützt; jede Änderung führt Enterprise Architect aus – bei aktivierter Sicherheit unter dem EA-Konto des Assistenten, mit dessen Berechtigungen und Sperren. Objekte, die andere Benutzer gesperrt haben, bleiben unangetastet.
• Anweisungen nur von Ihnen: Inhalte von Anhängen, Dokumenten und Modell soll der Assistent als Daten behandeln, nicht als auszuführende Anweisungen.
• Änderungsprotokoll: Jede Speicherung, auch eine fehlgeschlagene, wird mit Zeit, Konto und Ergebnis festgehalten und lässt sich nach Excel exportieren.
• Baselines: Vor dem Löschen oder größeren Umbau eines bestehenden Pakets ist der Assistent angewiesen, zuerst eine Baseline davon anzulegen; wiederhergestellt wird sie in EA (Manage Baselines → Compare/Restore).

Trotzdem: Löschen ist endgültig, und KI kann sich irren – die Anwendung weist darauf hin; prüfen Sie die vorgeschlagenen Änderungen daher vor der Freigabe. Nutzen Sie bei wichtigen Modellen den Modus ask und sichern Sie die Datenbank bzw. die Modelldatei – die Anwendung wird unentgeltlich und im vorliegenden Zustand bereitgestellt (Einzelheiten in der Lizenz).

Für eine Antwort sendet der Assistent an die Claude-API von Anthropic (api.anthropic.com) nur, was er braucht: Ihre Nachrichten und Anhänge, gemerkte Vereinbarungen, verwendete Vorlagen und das, was er in dieser Unterhaltung aus dem Modell gelesen hat – die Ergebnisse seiner Abfragen am Modell (Namen und Beschreibungen von Paketen, Elementen, Diagrammen) und Bilder der gezeigten Diagramme. Nicht das ganze Modell. Nach einem Sprachwechsel gehen auch Gedächtnis und Vorlagen zur Übersetzung dorthin.

Darüber hinaus gehen Daten nur dorthin, wohin Sie sie schicken: veröffentlichte Seiten in Ihr Confluence; Fehlermeldungen und die Newsletter-Anmeldung sind E-Mails, die Sie in Ihrem E-Mail-Programm prüfen und selbst senden. Von sich aus sendet die Anwendung nichts an Loonar. Prüfen Sie vor dem Einsatz an Firmenmodellen die Regeln Ihrer Organisation und die Datenverarbeitungsbedingungen Ihres Anthropic-Kontos.

Auf Ihrem Computer, in Ihrem Windows-Benutzerprofil – jeder Benutzer des Computers hat eigene:

• %APPDATA%\Loonar Compass: Einstellungen (app.properties), Unterhaltungsverlauf, Anhänge, Gedächtnis des Assistenten, Dokumentvorlagen und Änderungsprotokoll.
• Windows-Anmeldeinformationsverwaltung: Claude-API-Schlüssel, Passwort des EA-Kontos, Datenbankpasswort und Confluence-Token. Keines davon steht im Klartext in der Einstellungsdatei.

Das Programm selbst liegt standardmäßig unter %LOCALAPPDATA%\Programs\Loonar Compass, bei einer Installation für alle Benutzer unter C:\Program Files\Loonar Compass.

Ja, überall dort, wo die Anwendung selbst Verbindungen aufbaut:

• Claude-API und Confluence: nur über HTTPS. Eine Confluence-Adresse mit http:// wird nur für einen Server auf demselben Computer (localhost) akzeptiert.
• Modelldatenbank (PostgreSQL): TLS, einstellbar mit „Verschlüsselung der Verbindung“ auf der Karte „2. Modell“ in den Einstellungen (Option „PostgreSQL-Datenbank“): „Bevorzugt“ (Standard) – TLS, sofern der Server es anbietet, sonst eine unverschlüsselte Verbindung; „Erforderlich“ – TLS oder keine Verbindung; „Erforderlich, mit Zertifikatsprüfung“ – TLS, wobei Zertifikat und Name des Servers gegen den Windows-Zertifikatspeicher geprüft werden, einschließlich der Zertifikate Ihres Unternehmens. „Bevorzugt“ und „Erforderlich“ prüfen das Zertifikat nicht. Nach „Speichern und Verbindung prüfen“ zeigt die Anwendung an, ob die Verbindung verschlüsselt ist. In app.properties heißt die Einstellung db.sslmode = prefer, require oder verify-full.
• Modelldatei (.qea, .qeax): keine Datenbankverbindung – der Assistent liest die Datei direkt und nur lesend.

Tipp für Datenbankadministratoren: Mit hostssl-Einträgen in pg_hba.conf nimmt der Server von allen Clients nur TLS-Verbindungen an. Die eigene Verbindung von Enterprise Architect zur Datenbank richtet sich nach den Einstellungen von EA, nicht nach denen der Anwendung.

Benötigt werden diese Verbindungen: HTTPS (Port 443) zu api.anthropic.com, bei einem Datenbankmodell zu Ihrem PostgreSQL-Server (standardmäßig Port 5432; direkt, nicht über den Proxy) und – wenn Sie Seiten veröffentlichen – zu Ihrem Confluence.

Für HTTPS verwendet die Anwendung den Proxy aus den Windows-Internetoptionen (System-Proxy). Sie können auch die Umgebungsvariable HTTPS_PROXY oder ALL_PROXY setzen, z. B. http://proxy.example.com:8080 (Ausnahmen in NO_PROXY); sie hat Vorrang vor dem System-Proxy. Starten Sie die Anwendung nach einer Änderung neu. Bei Standardauthentifizierung (Basic) können Benutzername und Passwort Teil der Adresse in dieser Variablen sein; automatische Erkennung und Skripte zur automatischen Konfiguration (WPAD, PAC) sowie die Proxy-Anmeldung mit dem Windows-Konto (NTLM, Kerberos) werden nicht unterstützt.

HTTPS-Zertifikate werden auch gegen den Windows-Zertifikatspeicher geprüft – ein firmeneigenes Stammzertifikat für die Prüfung des Datenverkehrs wird also akzeptiert, sobald es in Windows installiert ist.

Deutsch, Englisch, Polnisch und Französisch: Fenster der Anwendung und des Installationsprogramms, Antworten des Assistenten, Standard-Dokumentvorlagen, Benutzerhandbuch, Lizenz und Änderungsliste. Das Installationsprogramm fragt zuerst nach der Sprache (Standard: Englisch); später ändern Sie sie in den Einstellungen auf der Karte „4. Sprache und Freigabe von Änderungen“.

Der Assistent antwortet in der Sprache der Anwendung, außer Sie schreiben ihm in einer anderen. Der Unterhaltungsverlauf wird nie übersetzt.

Ja, mit beiden – und Confluence ist optional. Auch ohne erstellt der Assistent Seiten; den Code fügen Sie dann selbst im Quelltext-Editor ein („Seitencode kopieren“, „Bilderordner öffnen“).

Zum direkten Veröffentlichen füllen Sie in den Einstellungen die Karte „6. Confluence“ aus: für Data Center Adresse und persönliches Zugriffstoken (PAT), für Cloud Adresse (https://ihre-firma.atlassian.net/wiki), E-Mail des Kontos und API-Token, dazu den Bereichsschlüssel und optional eine übergeordnete Seite. Der Assistent legt Seiten dann über die REST-API an oder aktualisiert sie, mit Diagrammen als Anhängen – immer erst nach Ihrer Freigabe (die Anfrage sagt ausdrücklich, wenn eine bestehende Seite ersetzt wird; die vorherige Version bleibt im Seitenverlauf erhalten) und mit den Berechtigungen dieses Tokens.

Schließen Sie die Anwendung und starten Sie das Installationsprogramm der neueren Version. Es schlägt denselben Ordner vor, zeigt die Änderungen seit Ihrer Version und behält Einstellungen, Unterhaltungsverlauf, Anhänge, Gedächtnis, Vorlagen und Änderungsprotokoll; Schlüssel, Passwörter und Tokens in der Anmeldeinformationsverwaltung bleiben ebenfalls. Neue Versionen erscheinen hier und auf GitHub.

Schließen Sie die Anwendung und verwenden Sie „Loonar Compass deinstallieren“ im Startmenü oder den Eintrag unter Windows-Einstellungen → Apps → Installierte Apps. Entfernt werden Programmdateien, Verknüpfungen und der Systemeintrag. Ihre Daten bleiben erhalten, es sei denn, Sie aktivieren eine dieser Optionen:

• „Einstellungen, Unterhaltungen, Anhänge, Gedächtnis des Assistenten, Dokumentvorlagen und Änderungsprotokoll entfernen“ – löscht den ganzen Ordner %APPDATA%\Loonar Compass;
• „API-Schlüssel, Passwörter und Tokens aus der Anmeldeinformationsverwaltung entfernen“ – Claude-API-Schlüssel, Passwörter des EA-Kontos und der Datenbank sowie Confluence-Token.

Ihr EA-Modell, anderswo gespeicherte Dateien und in Confluence veröffentlichte Seiten bleiben unberührt.

Öffnen Sie in der Anwendung „Fehler melden“ in der Navigationsleiste, beschreiben Sie, was passiert ist, fügen Sie Screenshots hinzu und klicken Sie auf „Meldung senden“: In Ihrem Standard-E-Mail-Programm öffnet sich eine fertige Nachricht an mariusz@loonar.eu, die Sie prüfen und senden. Technische Informationen (Anwendungsversion, Windows-Version, KI-Modell, Freigabemodus, letzte Meldung – ohne Passwörter und Schlüssel) werden nur angehängt, solange diese Option aktiviert ist (standardmäßig ja).

Neuigkeiten zu Versionen: E-Mail-Adresse auf der Karte „5. Neue Versionen (Newsletter)“ in den Einstellungen eintragen und die Einwilligung ankreuzen. Oder schreiben Sie einfach an mariusz@loonar.eu.