Agent installieren — DucKI Agent

PowerShell / Windows Terminal

Eingabeaufforderung (CMD)

Nach der Installation

1 Der Agent läuft danach als Dienst auf http://localhost:3001 und startet automatisch mit.
2 Öffne die Web-UI — im Free-Modus verbindet sie sich automatisch mit deinem lokalen Agenten.
3 Trage bei Bedarf unter „Backend-Verbindung" deine eigene URL ein (z. B. via Tailscale).

Optional: Web-UI lokal betreiben

Standardmäßig nutzt du die gehostete Web-UI unter /app. Wenn du auch die Oberfläche selbst hosten möchtest (voll offline, ohne Cloud-Verbindung), installiert dieses zweite Skript die Web-UI auf deinem Rechner und startet sie unter http://localhost:5173. Es baut die UI und liefert sie per Autostart-Dienst aus; Anfragen an /api und /socket.io werden an deinen lokalen Agenten (http://localhost:3001) weitergeleitet.

Voraussetzung: Der Agent muss bereits installiert sein (Befehl oben) — die lokale Web-UI verbindet sich mit ihm.

PowerShell / Windows Terminal

Eingabeaufforderung (CMD)

Anpassbar per Umgebungsvariable: DUCKI_WEB_PORT (Standard 5173), DUCKI_WEB_HOST (Standard 127.0.0.1; 0.0.0.0 für Zugriff im lokalen Netz/Tailscale), DUCKI_PORT (Agent-Port, Standard 3001). Erneutes Ausführen aktualisiert und baut neu. Der Abschnitt richtet sich nach den Betriebssystem-Tabs oben.

Windows — ganz ohne Kommandozeile

Kein PowerShell, kein Git, kein Node.js nötig: ZIP entpacken, .exe starten, fertig.

DucKI Node — Komplettpaket Empfohlen

ZIP-Archiv · 93,7 MB · Server + Oberfläche in einem Prozess · keine Adminrechte nötig

.zip herunterladen

Entpacken und ducki-node.exe darin starten — das war's. Bringt seine eigene Node.js-Laufzeit mit (kein separates Node.js/Git nötig), startet den Agenten sofort auf http://localhost:3001 und öffnet ein natives Fenster mit der Oberfläche. Läuft danach als Tray-Icon weiter (Ente unten rechts in der Taskleiste) — Rechtsklick für „Oberfläche öffnen", „Agent neu starten", „Logs öffnen" und Autostart an/aus; Windows-Benachrichtigungen informieren über Start und Neustarts. Schließen des Fensters minimiert nur in den Tray, „Beenden" im Menü stoppt Server und App vollständig. Wichtig: den kompletten entpackten Ordner zusammenlassen (ducki-node.exe, node.exe und resources/ gehören zusammen).

SHA-256 (zum Verifizieren)

76becbb811423bc997a62a9d722b1eee7ffdf2a8f5dca11b432be9db4285296b

Prüfen (PowerShell): Get-FileHash .\ducki-node-app-x64.zip -Algorithm SHA256

Lieber Server und Oberfläche getrennt — z. B. für einen Agenten ohne Fenster im Hintergrund, oder eine eigene Oberfläche für einen bereits laufenden Agenten (Skript-Installer oben)? Beide Komponenten gibt es auch einzeln:

DucKI Server — nur der Agent (Windows x64)

ZIP-Archiv · 91,3 MB · bringt Node.js mit · ohne Oberfläche

.zip herunterladen

Entpacken und ducki-server.exe darin ausführen. Startet nur den Agenten (kein Fenster) auf http://localhost:3001 — praktisch, wenn du ausschließlich die gehostete Web-UI nutzen willst.

SHA-256 (zum Verifizieren)

6d9b5cdd17b65cb3c6d98fb1e3a82532b79f03fffc1d001d1560a237db6b69ed

Prüfen (PowerShell): Get-FileHash .\ducki-node-server-x64.zip -Algorithm SHA256

DucKI UI — nur die Oberfläche (Windows x64)

ZIP-Archiv · 3,9 MB · keine Installation · ohne eigenen Agenten

.zip herunterladen

Entpacken und ducki-node-ui.exe darin starten. Nur das native Fenster, ohne eigenen Agenten — verbindet sich mit einem bereits laufenden Agenten auf http://localhost:3001 (z. B. aus dem Server-Paket oben oder dem Skript-Installer). Andere Adresse unter Einstellungen → Backend-Verbindung.

SHA-256 (zum Verifizieren)

ed07ace9e223edf3232fec7b853acfbdf6ee2030b0ed4ca668bba51e08dd15ff

Prüfen (PowerShell): Get-FileHash .\ducki-node-ui-x64.zip -Algorithm SHA256

Open Source — selbst prüfen & kompilieren

Du musst diesen Downloads nicht blind vertrauen: Der komplette Quellcode liegt offen auf GitHub. Sieh ihn dir an und baue ihn bei Bedarf selbst — funktional identisch mit den Downloads hier.

Hinweis: Am GitHub-Repo wird laufend weiterentwickelt — neue Funktionen und Bugfixes landen dort zuerst. Die fertigen .zip/.exe-Downloads oben sind Snapshots und werden nicht bei jedem Commit neu gebaut. Wer schnell von neuen Bugfixes profitieren will, ist mit git clone + selbst bauen (unten) oder dem Skript-Installer oben (der bei jedem erneuten Ausführen aktualisiert) aktueller dran als mit den Standalone-Downloads.

git clone https://github.com/davidduckwitz/ducKI-Agent.git
cd ducKI-Agent
pnpm install
pnpm --filter @ducki/tauri-desktop run dist   # Komplettpaket (Server + Oberfläche)
pnpm --filter @ducki/tauri-server run dist    # nur der Agent
pnpm --filter @ducki/tauri-ui run dist        # nur die Oberfläche

Die fertigen Dateien liegen dann unter apps/tauri-desktop/src-tauri/target/release/, apps/tauri-server/src-tauri/target/release/ bzw. apps/tauri-ui/src-tauri/target/release/. Bei Desktop und Server ergeben *.exe + node.exe + resources/ zusammen das portable Paket; die reine UI ist eine einzelne, eigenständige .exe ohne weitere Dateien (Voraussetzungen: Rust + Node ≥ 20).

→ Quellcode auf GitHub ansehen (ducKI-Agent)

Von überall nutzen — HTTPS via Tailscale

Nötig, wenn du die gehostete Cloud-UI (https) mit deinem lokalen Agenten verbindest.

Öffnest du die Web-UI über https://… (die gehostete Version), blockt der Browser eine Verbindung zu http://localhost:3001 (Mixed Content). Lösung: Mach deinen Agenten per Tailscale über HTTPS erreichbar — dann sind UI und Agent beide https. Alle Befehle laufen auf dem Rechner, auf dem der Agent installiert ist.

Voraussetzung (einmalig): Im Tailscale-Admin unter DNS müssen MagicDNS und HTTPS Certificates aktiviert sein — sonst kann tailscale serve kein HTTPS bereitstellen (Fehler „account does not support getting TLS certs").

1
Tailscale installieren & anmelden

Kostenlos herunterladen unter tailscale.com/download (Windows, macOS, Linux) — auf demselben Rechner wie der Agent installieren. Dann anmelden:
```
tailscale up
```
2
Agent über HTTPS freigeben

Proxied HTTPS (Port 443) → deinen Agenten auf localhost:3001.
```
tailscale serve --bg 3001
```
3
URL prüfen
```
tailscale serve status
```
Zeigt deine URL, z. B.
https://<gerät>.<tailnet>.ts.net → http://127.0.0.1:3001
4

URL in der Web-UI eintragen

„Backend-Verbindung" → Remote → deine https://…ts.net-URL ohne Port (nicht …ts.net:3001 — dort spricht der Agent nur HTTP → TLS-Fehler). Neu laden — fertig.

Zugriff nur im eigenen Tailnet. tailscale serve ist tailnet-intern — dein Browser muss im selben Tailnet sein. Für Zugriff von außerhalb: tailscale funnel 3001 (öffentlich erreichbar).

Plugin-UIs. Der Installer erlaubt das Einbetten durch die gehostete Cloud-UI automatisch (setzt DUCKI_FRAME_ANCESTORS). Nutzt du eine eigene UI-Domain, setze diese Env auf deren Origin.

Rein lokal? Läuft die Web-UI ebenfalls über http (z. B. http://localhost:8000 → http://localhost:3001), brauchst du Tailscale gar nicht — das funktioniert direkt.

Sicherheit & Transparenz

Die Skripte laufen im Benutzerkontext (kein Admin nötig, sofern Node/git vorhanden), sind idempotent und quelloffen. Vorher ansehen: install.sh · install.ps1 · install-webui.ps1 · install-webui.sh. Der Agent-Quellcode: GitHub.