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 API-Schlüssel – Claude aus der Anthropic Console oder OpenAI von der OpenAI-Plattform; der Anbieter 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 und der Preisseite von OpenAI.

Standard ist Claude Haiku 5.5 (claude-haiku-5-5). Unter Einstellungen → „KI-Modell“ können Sie Anbieter, Modell und Aufwand (Effort) ändern; höherer Aufwand und größere Modelle kosten mehr. „Max. Tokens“ (standardmäßig 10.000) begrenzt nur die Länge einer einzelnen Antwort: Sie zahlen für den tatsächlich erzeugten Text.

Ja. Wählen Sie in den Einstellungen → „KI-Modell“ OpenAI und geben Sie die Adresse eines OpenAI-kompatiblen Endpunkts ein: Azure OpenAI in Ihrem eigenen Tenant, ein KI-Gateway des Unternehmens oder einen lokalen Modellserver wie Ollama oder LM Studio (zum Beispiel http://localhost:11434/v1). Die Adresse muss HTTPS verwenden; einfaches http ist nur für einen Server auf demselben Rechner erlaubt. Ein lokales Modell braucht keinen API-Schlüssel, und dann verlässt nichts Ihren Rechner.

Kleinere lokale Modelle befolgen lange Anweisungen weniger zuverlässig als große Cloud-Modelle – bevor Sie eines in ein wichtiges Modell schreiben lassen, testen Sie es an einer Kopie.

• Confluence (Data Center oder Cloud): Seiten aus dem Modell, veröffentlicht nach Ihrer Freigabe.
• Jira (Cloud oder Data Center): Vorgänge als Kontext; neue Vorgänge, Kommentare und Links zu Elementen nach Ihrer Freigabe.
• MCP-Server: Jeder hinzugefügte Server – ein lokales Programm oder eine HTTP-Adresse – gibt dem Assistenten weitere Werkzeuge; jeder Aufruf fragt nach Zustimmung, außer Sie haben den Server als vertrauenswürdig markiert.
• Compass Hub als MCP-Server: Andere KI-Werkzeuge lesen die Modelle des Teams, nur lesend.
• Quellcode: ein Ordner im Vergleich mit dem Modell – Java, Kotlin, C#, TypeScript, Rust, Python, SQL-Tabellen und OpenAPI-Operationen.
• Dateien: Word, Excel, PNG, XMI und Dokumente aus EA-Berichtsvorlagen.

Ja, mit dem optionalen Compass Hub: ein eigener Dienst auf einem Team-Server - compass-hub.exe unter Windows (auch als Windows-Dienst), ein Linux-Programm oder ein Docker-Image - mit den Modellen des Teams, Benutzern, die sich mit Name und Passwort oder Token anmelden und Rollen haben (viewer, architect, admin), gemeinsamen Regeln der Modellprüfung und einem minimalen Freigabemodus. Jedes Speichern an jedem Arbeitsplatz landet in seinem Audit-Protokoll, und Änderungen lassen sich zur Prüfung vorschlagen und von einem zweiten Architekten freigeben. Kollegen ohne EA öffnen den Hub im Browser, suchen im Modell, sehen Prüfergebnisse und stellen dem Assistenten Fragen – nur lesend. Architekten legen Jira-Vorgänge und Confluence-Seiten direkt aus der Weboberfläche an. Die erste Anmeldung erfolgt mit dem Standardkonto admin / passw0rd, dessen Passwort sofort geändert werden muss.

Der Hub selbst spricht einfaches HTTP: Für den Zugriff von anderen Rechnern setzen Sie ihn hinter einen HTTPS-Reverse-Proxy (etwa IIS, nginx oder Traefik). Ohne Hub arbeitet jeder Architekt wie bisher für sich.

Seit 0.9 melden sich Benutzer mit ihrem Firmenkonto am Hub an (OpenID Connect: Microsoft Entra ID, AD FS), Rollen ergeben sich aus ihren Gruppen, und die IT kann Compass still verteilen und den Hub per Windows-Richtlinie (GPO oder Intune) vorschreiben. Wie die IT den Hub installiert: Installationsanleitung für die IT.

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 „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.
• Mehrere Modelle: Jede Unterhaltung hat ihr eigenes Modell, das in ihrer Kopfzeile steht („Modell: …“). Eine neue Unterhaltung verwendet das Standardmodell aus den Einstellungen; mit „Anderes Modell wählen…“ – oder einem Klick auf die Kopfzeile, der „Modell dieser Unterhaltung“ öffnet – wählen Sie eine andere PostgreSQL-Datenbank (Server, Port, Datenbank, Konto, Passwort, Verschlüsselung) oder EA-Datei (.qea, .qeax) samt EA-Konto und testen die Verbindung. Eine auf das Fenster gezogene .qea/.qeax-Datei wird zum Modell der Unterhaltung. Unterhaltungen aus früheren Versionen erhalten eine Kopie des Modells aus den Einstellungen. Enterprise Architect im Hintergrund hat jeweils ein Modell geöffnet; der Wechsel zu einem anderen Modell dauert einige Sekunden bis etwa 25 Sekunden.

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.9.2 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.9.2.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.
• Geprüftes Speichern: Nach jedem Speichern wird das Modell neu gelesen und mit dem Auftrag verglichen; ein auf halbem Weg abgebrochenes Speichern hinterlässt nichts, und das Löschen eines Elements mit Beziehungen fragt immer nach und nennt diese Beziehungen.
• Rückgängig und Baselines: Was der Assistent angelegt oder geändert hat, lässt sich rückgängig machen („Mach die letzte Änderung rückgängig“); ein Löschen macht Compass nicht rückgängig, deshalb legt es vorher eine EA-Baseline des Pakets an, die Sie in EA wiederherstellen (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 den in den Einstellungen gewählten KI-Anbieter – die Claude-API von Anthropic (api.anthropic.com) oder die OpenAI-API (api.openai.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 sowie die für Sie gelesenen Quelldateien und Dokumente. 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, Vorgänge in Ihr Jira, Änderungssätze und das Audit-Protokoll an den Compass Hub Ihres Teams, hochgeladene Dokumente in Ihr SharePoint, OneDrive oder Google Drive, Werkzeugaufrufe an die von Ihnen hinzugefügten MCP-Server; eine Fehlermeldung geht, wenn Sie sie senden, als öffentliches GitHub-Issue (Bildschirmfotos und die gemeldete Antwort nur an den Autor) oder als E-Mail aus Ihrem E-Mail-Programm. Von sich aus sendet die Anwendung an Loonar nur eine anonyme Nutzungsstatistik – bei jedem Start und stündlich: eine zufällige Installations-ID, die Version, Arten von Aufgaben und ihr Ergebnis, Zahlen zu genutzten Funktionen und Fehlern, nie den Inhalt von Unterhaltungen oder etwas aus dem Modell. Nur der Autor sieht sie, veröffentlicht werden nur Zusammenfassungen über alle Installationen, und sie lässt sich in der Ansicht „Nutzungsstatistik“ ausschalten. Prüfen Sie vor dem Einsatz an Firmenmodellen die Regeln Ihrer Organisation und die Datenverarbeitungsbedingungen Ihres Anthropic- bzw. OpenAI-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: API-Schlüssel für Claude und OpenAI, Passwort des EA-Kontos, Datenbankpasswort, Confluence- und Jira-Token und der Compass-Hub-Token sowie die Passwörter eines Unterhaltungsmodells, das von den Einstellungen abweicht. 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-/OpenAI-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 „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 oder api.openai.com (je nach Anbieter) oder zur Adresse Ihres Azure OpenAI bzw. Gateways, bei einem Datenbankmodell zu Ihrem PostgreSQL-Server (standardmäßig Port 5432; direkt, nicht über den Proxy) und – wenn Sie sie nutzen – zu Ihrem Confluence, Ihrem Jira und dem Team-Hub.

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 „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 „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“ – API-Schlüssel für Claude und OpenAI, 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 „Neue Versionen (Newsletter)“ in den Einstellungen eintragen und die Einwilligung ankreuzen. Oder schreiben Sie einfach an mariusz@loonar.eu.