Ciele Desktop

Ciele Desktop ist eine Anwendung für macOS und Windows, die sich nach Ihrer Wahl öffnet.

• Sign in to your organization: Die App öffnet die Konsole Ihrer Organisation in einem eigenen Fenster, wobei die Sitzung auch nach einem Neustart fortbesteht. Die Adresse ist konfigurierbar, sodass derselbe Pfad auch zu einem selbst gehosteten Ciele auf Ihrem eigenen Server führt.
• Use locally (self-host): Eine geführte Einrichtung richtet auf diesem Rechner ein komplettes Ciele ein: Datenbank, Migrationen, geplante Jobs und alles Weitere. Es wird kein Terminal benötigt, und Docker Desktop ist das Einzige, was Sie selbst installieren.

Beide können nebeneinander existieren, und Sie können jederzeit zwischen ihnen wechseln. Alles, was Sie tatsächlich mit Ciele machen, geschieht in der Ihnen bereits bekannten Produkt-Benutzeroberfläche. Die App fügt ein Fenster darum herum hinzu, keine zweite Benutzeroberfläche.

Welchen Weg wählen?

Der lokale Pfad ist ein echtes Ciele, keine Demo: dieselben Container, dieselben Migrationen, dieselben geplanten Jobs, die der Server-Self-Host ausführt. Es ist nicht dafür gedacht, ein Produktions-Widget für die Öffentlichkeit bereitzustellen, da dafür eine Adresse erforderlich ist, die die Öffentlichkeit erreichen kann.

Installieren

Beide Downloads finden Sie im neuesten Release.

macOS

1. Laden Sie die .zip für Ihren Prozessor herunter.
2. Entpacken Sie es und verschieben Sie Ciele.app in Ihren Ordner „Programme“.
3. Right-click (or Control-click) Ciele.app and choose Open, dann im Dialogfeld erneut Open.

Dieser dritte Schritt ist wichtig. Die Beta-Version ist nicht signiert. Daher blockiert macOS einen Doppelklick auf die übliche Weise, bis Sie sie einmal auf diese Weise geöffnet haben. Sie müssen dies nur einmal tun.

Windows

1. Laden Sie das Installationsprogramm Setup.exe herunter.
2. Führen Sie es aus. SmartScreen meldet „Windows hat Ihren PC geschützt“, da die Beta-Version nicht signiert ist. Wählen Sie More info und dann Run anyway.

Wenn der Download selbst blockiert ist, klicken Sie mit der rechten Maustaste auf die Datei, öffnen Sie Properties und aktivieren Sie Unblock.

Anmeldung bei Ihrer Organisation

Wählen Sie Sign in auf dem Begrüßungsbildschirm. Die App lädt die Konsole Ihrer Organisation und merkt sich die Sitzung, sodass Sie bei späteren Starts direkt dorthin gelangen.

Um die App stattdessen auf einen selbst gehosteten Server zu verweisen, öffnen Sie Settings und ändern Sie die Serveradresse. Sie erreichen sie über das Steuersymbol auf dem Begrüßungsbildschirm oder mit ⌘, unter macOS und Ctrl+, unter Windows. Alles, was http:// oder https:// ist, funktioniert. Die App behält den Ursprung bei und entfernt jeden Pfad, den Sie damit einfügen.

Die App gibt dieselben kurzen Benutzeroberflächentöne wieder wie die Konsole. Interface sounds in Settings schaltet sie für diesen Rechner aus.

Sign out löscht die gespeicherte Sitzung der App für diesen Server: Cookies, Cache und alles. Es schließt mehr als nur das Fenster. Auf einem gemeinsam genutzten Computer ist dies die richtige Vorgehensweise.

Wenn die Adresse nicht geladen wird, zeigt die App dies auf ihrem eigenen Bildschirm an. Sie zeigt die Adresse an, die sie versucht hat, was schiefgelaufen ist, und Schaltflächen, um es erneut zu versuchen oder zu korrigieren. Sie landen niemals auf einer Browser-Fehlerseite in einem Fenster ohne Adressleiste.

Einrichten eines lokalen Ciele

Wählen Sie Use locally. Der Assistent führt jeden Schritt aus und überprüft ihn, bevor er den nächsten öffnet. Ein grünes Häkchen bedeutet, dass der Schritt funktioniert hat, nicht, dass er abgeschlossen ist.

1. Docker Desktop

Der Assistent prüft, ob Docker Desktop installiert ist und ausgeführt wird. Das sind unterschiedliche Probleme mit unterschiedlichen Lösungen, und es wird angegeben, welches Problem Sie haben. Für jeden Fehler gibt es eine eigene Schritt-für-Schritt-Anleitung, die für jemanden geschrieben wurde, der noch nie Entwicklertools installiert hat. Der Installationslink verweist auf die Seite für Ihre Plattform. Installieren oder starten Sie Docker Desktop und drücken Sie dann Try again. Die Prüfung wird an Ort und Stelle erneut ausgeführt.

2. Datenordner und Secrets

Die App erstellt einen Ordner für diese Installation und generiert jedes Passwort und jeden Schlüssel, die der Stack benötigt. Sie bearbeiten niemals eine Umgebungsdatei.

Wenn bereits eine Konfiguration vorhanden ist, behält die App diese bei, anstatt eine neue zu generieren. Ihre Datenbank ist mit den Secrets versiegelt, die sich bereits in diesem Ordner befinden. Neue Secrets würden Sie davon ausschließen.

3. Laden Sie Ciele herunter

Ruft die veröffentlichten Container-Images für diese Version der App ab. Dies ist der langsame Schritt bei der ersten Ausführung. Es wird nichts aus dem Quellcode erstellt, weshalb die Einrichtung nur eine Kaffeepause dauert und nicht den ganzen Nachmittag in Anspruch nimmt.

4. Starten Sie den Stack

Startet die Datenbank, die App und die geplanten Jobs in einem separaten Prozess. Sie laufen weiter, nachdem Sie Ciele Desktop beendet haben.

5. Vorbereitung der Datenbank

Wendet das Schema an und wartet auf die Antwort von Ciele. „Die Container wurden gestartet“ und „Ciele liefert“ sind unterschiedliche Aussagen, und dieser Schritt wartet auf die zweite.

6. Demo-Inhalte (optional)

Lädt eine Beispielorganisation mit Assistenten, sodass Sie ein bereits befülltes Produkt sehen, bevor Sie eigene Inhalte hinzufügen. Skip hinterlässt Ihnen ein leeres, funktionsfähiges Ciele.

7. Verbinden Sie ein KI-Modell (optional)

Richten Sie Ciele auf einen beliebigen OpenAI-kompatiblen Server oder einen gehosteten Anbieter. Für Ollama auf diesem Rechner lautet die Adresse http://host.docker.internal:11434/v1: innerhalb eines Containers ist localhost der Container.

Überspringen ist in Ordnung. Ohne Modell antworten die Assistenten über die integrierte Schlüsselwort-Engine, und die Wissenssuche greift auf lexikalischen Abgleich zurück. Alles andere funktioniert.

Wenn ein Schritt fehlschlägt, wird angegeben, was fehlgeschlagen ist, und die Protokolle werden unter Show details gespeichert. Try again setzt dann an diesem Schritt fort, anstatt von vorne zu beginnen.

Sobald die Einrichtung abgeschlossen ist, lädt Open Ciele die lokale Konsole. Das erste Konto, das Sie erstellen, ist Eigentümer der Organisation. Bei späteren Starts wird der Assistent vollständig übersprungen.

Tag zwei

Stack status zeigt an, ob Ihr lokaler Stack läuft. Sie erreichen sie über den letzten Schritt des Assistenten, über die Einstellungen oder über das Ciele-Menü. Es startet und stoppt den Stack ohne Docker Desktop. „Running“ bedeutet dort, dass Ciele geantwortet hat, nicht, dass Container existieren.

Das Stoppen ist reversibel und berührt keine Daten. Wenn Sie die App beenden, wird der Stack nicht gestoppt. Sie läuft bewusst getrennt.

Wo Ihre Daten gespeichert sind

Sichern Sie die Datenbank auf die gleiche Weise wie bei jedem Self-Hosting, siehe Datenbank. Durch die Deinstallation der App werden weder die Volumes noch der Stack entfernt.

Aktualisierung

Die App prüft beim Start, ob eine neuere Version verfügbar ist, und zeigt einen ausblendbaren Hinweis mit einem Download-Link an. Es gibt keine automatische Aktualisierung, da keine der Plattformen eine nicht signierte App automatisch aktualisiert.

Durch das Aktualisieren der App wird Ihr lokaler Stack aktualisiert. Jeder Build fixiert die Container-Images, die zu seiner eigenen Version passen, sodass das nächste Setup oder der nächste Start diese abruft und die Migrationen erneut ausführt. Ihre Daten bleiben dort, wo sie sind.

Neustart

Um die lokale Installation zurückzusetzen, stoppen Sie den Stack über den Statusbildschirm und entfernen Sie die Volumes des Compose-Projekts mit Docker Desktop oder über ein Terminal:

docker compose --project-name ciele down -v

Dadurch werden die lokale Datenbank und die hochgeladenen Dateien gelöscht. Wenn Sie das nächste Mal Use locally wählen, wird der Assistent von Anfang an ausgeführt.

Fehlerbehebung

"Docker Desktop ist nicht installiert", obwohl dies der Fall ist. Eine Anwendung, die über das Dock oder das Startmenü gestartet wird, übernimmt nicht die PATH Ihrer Shell. Ciele sucht daher nach der Docker-CLI dort, wo Docker Desktop sie installiert. Unter macOS sind dies die Speicherorte Homebrew und /usr/local/bin. Unter Windows ist dies der Ordner „Programme“ und der benutzerdefinierte Ordner „Programme“. Es wird nirgendwo anders einen Docker finden, den Sie installiert haben. Unter macOS behebt ein Symlink nach /usr/local/bin dieses Problem.

The stack sits on "Starting". Postgres initialisiert möglicherweise noch bei der ersten Ausführung. Warten Sie eine Minute und drücken Sie dann Check again. Wenn es dort bleibt, öffnen Sie die Protokolle über Docker Desktop. Ein Container, der immer wieder neu startet, hat in der Regel zu wenig Speicher.

"Die Bilder konnten nicht heruntergeladen werden." Der Pull konnte die Registry nicht erreichen. Überprüfen Sie Ihre Verbindung oder Ihren Proxy und drücken Sie Try again. Es wurde nichts nachgelagert ausgeführt, daher gibt es nichts rückgängig zu machen.

Assistants answer, but they ignore my knowledge. Es ist kein Embedding-Modell konfiguriert, daher greift der Abruf auf den Schlüsselwortabgleich zurück. Fügen Sie ein Embedding-Modell in Configuration hinzu.

„Ciele wurde nicht geladen“, als ich mich anmelden wollte. Die Adresse in den Einstellungen liefert Ciele nicht. Der Bildschirm benennt, was schiefgelaufen ist. Ein Tippfehler führt zu der Meldung „Diese Adresse existiert nicht“. Ein ausgeschalteter Server meldet „nothing is listening“. Eine Adresse, die antwortet, ohne Ciele zu sein, sagt dies. Change address führt Sie direkt zur Einstellung.

macOS meldet, dass die App beschädigt ist oder nicht geöffnet werden kann. Das ist Gatekeeper bei einer nicht signierten App. Klicken Sie mit der rechten Maustaste auf Ciele.app, wählen Sie Open und dann erneut Open. Ein Doppelklick bietet diese Option nicht an.

Windows blocks the installer. Das ist SmartScreen bei einer nicht signierten App. Wählen Sie More info und dann Run anyway. Wenn die Datei beim Herunterladen blockiert wurde, heben Sie zuerst die Blockierung in ihrem Properties auf.

Was die Desktop-App nicht ist

• Sie stellt keine Produktions-Widgets bereit. Lokale Widgets dienen zum Testen und zur Vorschau. Für die Veröffentlichung für echte Besucher ist ein erreichbarer Server erforderlich.
• Sie ist weder signiert noch notariell beglaubigt und wird nicht automatisch aktualisiert.
• Sie führt nur die Standardprofile aus. Die optionalen Heavy-Worker bleiben deaktiviert. Fügen Sie sie bei Bedarf über Workers hinzu.