Erste Schritte
DuckLocal ist eine Desktop-App, mit der Sie Fragen an die Datendateien auf Ihrem Rechner in SQL stellen. Es gibt keinen Server, keine Verbindung zum Einrichten und kein Konto — Sie zeigen auf Dateien und beginnen mit dem Abfragen. Diese Seite führt Sie in etwa fünf Minuten vom Download zum ersten Ergebnis.
1. Installieren
DuckLocal läuft unter macOS, Windows und Linux. Die folgenden Links laden das neueste Release von dl.ducklocal.app herunter; dieselben Dateien und Release Notes finden Sie auf GitHub.
Diese Anleitungen sind für v0.4.1 aktualisiert, veröffentlicht am 15. November 2026. Version 0.4.0 ergänzte Agent-Workflows: eingeschränktes SQL, eine geprüfte Übergabe an das Fenster, Dashboard-Vorschläge, Analyseaufzeichnungen und portable Projekte. Version 0.4.1 ergänzt Mehrfachauswahl-Filter, eine Zeitzone und ein Zeitstrahl-Diagramm für Dashboards, view-Blöcke, die gemeinsames SQL einmal halten, Community-Erweiterungen wie mssql im Tab „Erweiterungen“ und eine Rückfrage zum Speichern für Tabellen, die in der In-Memory-Datenbank angelegt wurden. Wenn Sie von einer Version vor 0.3.0 aktualisieren, installieren Sie Ihre Erweiterungen neu: Mit diesem Release wechselte DuckLocal auf DuckDB 2.0.
Mac
Sie brauchen macOS 12 oder neuer auf Apple silicon (M1 oder neuer).
- Laden Sie
ducklocal-macos-arm64.dmgherunter. - Öffnen Sie die Datei und ziehen Sie DuckLocal auf Programme.
- Starten Sie DuckLocal über Programme oder Spotlight.
Das Disk-Image ist von Apple signiert und notarisiert und öffnet sich daher ohne Umweg über Gatekeeper.
Windows
Sie brauchen 64-Bit Windows 10 oder neuer.
- Laden Sie
ducklocal-windows-x86_64.zipherunter und entpacken Sie sie. - Führen Sie
ducklocal.exeaus dem entpackten Ordner aus. Der Build ist noch nicht code-signiert, daher kann beim ersten Start Windows hat Ihren PC geschützt erscheinen — wählen Sie Weitere Informationen und dann Trotzdem ausführen.
Linux
Sie brauchen ein x86_64-System mit glibc 2.35 oder neuer (Ubuntu 22.04, Debian 12, Fedora 36 oder neuer) und Grafiktreiber mit Vulkan-Unterstützung.
curl -LO https://dl.ducklocal.app/latest/ducklocal-linux-x86_64.tar.gz
tar -xzf ducklocal-linux-x86_64.tar.gz
./ducklocal-linux-x86_64/ducklocalStattdessen aus dem Quellcode bauen
Sie brauchen Rust stable 1.85.1 oder neuer und eine C++-Toolchain (Xcode Command Line Tools). DuckDB wird aus mitgelieferten Quellen kompiliert, daher dauert der erste Build mehrere Minuten und belegt ein paar Gigabyte Plattenplatz.
git clone https://github.com/JetSquirrel/DuckLocal
cd DuckLocal
cargo build --release
./target/release/ducklocalDie Binary ist ./target/release/ducklocal; verwenden Sie sie überall dort, wo diese Anleitung ducklocal nennt. Wie Sie ein .app bündeln, steht unter Entwicklung.
2. Den Befehl ducklocal hinzufügen (optional)
Alles in der App funktioniert ohne Terminal. Wenn Sie Daten auch von der Kommandozeile öffnen möchten — oder einen KI-Agenten sie mit der CLI analysieren lassen wollen —, fügen Sie den Befehl in der App hinzu:
- Klicken Sie auf die Roboter-Schaltfläche in der Titelleiste oder wählen Sie DuckLocal → Kommandozeile & KI… in der Menüleiste.
- Klicken Sie auf Befehl installieren. Auf einem Mac fragt das System nach Ihrem Passwort, um nach
/usr/local/binzu schreiben. - Öffnen Sie ein neues Terminal und prüfen Sie ihn:
ducklocal --version.
Der Befehl ist ein Link auf die App, daher aktualisiert ein DuckLocal-Update auch den Befehl. Zum Aktualisieren klicken Sie auf die Version am rechten Ende der Statusleiste: Ein neueres Release wird heruntergeladen und beim Neustart installiert (siehe Update-Prüfung). Auf einem Mac liegt er in /usr/local/bin, unter Linux in ~/.local/bin; unter Windows wird der Ordner der App zu Ihrem Path hinzugefügt.
Im selben Dialog installiert Zu Claude Code hinzufügen die DuckLocal-Skill, sodass Claude Code weiß, wie es Ihre Dateien abfragt, und Kurzbeschreibung kopieren kopiert eine kurze Erklärung, die Sie in jeden anderen KI-Agenten einfügen können. Siehe KI-CLI und offizielle Skill.
Manuell hinzufügen
sudo mkdir -p /usr/local/bin
sudo ln -sf /Applications/DuckLocal.app/Contents/MacOS/ducklocal /usr/local/bin/ducklocalZum Entfernen: sudo rm /usr/local/bin/ducklocal. Unter Linux verlinken Sie die entpackte Binary nach ~/.local/bin; unter Windows fügen Sie den entpackten Ordner zu Ihrem Path hinzu.
3. Daten öffnen
Beim ersten Start beginnt eine kurze Anleitung, geführt von der Ente: den KI-Agenten einbinden, Daten öffnen, die Seitenleiste, eine Abfrage ausführen und ihre Ergebnisse lesen. Überspringen schließt sie bei jedem Schritt. Um sie erneut zu sehen, wählen Sie Anleitung anzeigen im Menü DuckLocal auf einem Mac oder im Kontextmenü der Version am rechten Ende der Statusleiste.
Dahinter liegt ein Bildschirm mit dem Titel Daten hier ablegen. Von hier aus führen alle diese Wege zu Daten:
Ziehen Sie CSV-, TSV-, Parquet-, JSON- oder Excel-Dateien — oder einen ganzen Ordner — auf das Fenster.
Klicken Sie auf Dateien öffnen oder Ordner öffnen.
Auf einem Mac doppelklicken Sie eine
.parquet- oder.duckdb-Datei im Finder oder wählen DuckLocal für CSV-, JSON- und Excel-Dateien unter Öffnen mit. Siehe Im Finder öffnen.Aus einem Terminal nennen Sie die Pfade:
bashducklocal ./sales.csv # eine Datei ducklocal ./logs/ # jede Datendatei unter einem Ordner, rekursiv ducklocal './data/*.parquet' # ein Muster — in Anführungszeichen setzen, damit die Shell es nicht vorher expandiert ducklocal warehouse.duckdb # eine bestehende DuckDB-Datenbank
Jede Datei wird zu einer View, die nach der Datei benannt ist — sales.csv wird zu sales —, und erscheint unter Lokale Dateien in der Seitenleiste mit ihren Spalten und ihrer Zeilenzahl. DuckLocal liest die Dateien an ihrem Ort; nichts wird kopiert oder hochgeladen.
Geöffnete Dateien werden gemerkt, sodass der nächste Start mit demselben Workspace beginnt. Details zu Formaten, Ordnern, Mustern und Datenbanken finden Sie unter Datenquellen.
Auf einem Mac können Sie auch vor dem Öffnen in eine Datei hineinschauen: Wählen Sie sie im Finder aus und drücken Sie die Leertaste. Die Quick-Look-Vorschau von DuckLocal zeigt die Spalten und ersten Zeilen von Parquet-, DuckDB-, CSV-, TSV- und JSON-Lines-Dateien.
Keine Daten zur Hand?
Das Tutorial für die ersten 10 Minuten führt Schritt für Schritt durch eine kleine Beispieldatei.
4. Eine Abfrage ausführen
Klicken Sie auf Neue Abfrage (oder öffnen Sie Daten — der Editor erscheint von selbst). Geben Sie SQL ein und drücken Sie ⌘↵ (Cmd+Enter; unter Windows und Linux Ctrl+Enter):
SELECT * FROM sales LIMIT 20;Ersetzen Sie sales durch einen beliebigen View-Namen aus Ihrer Seitenleiste.
Das Ergebnis erscheint im Bereich unter dem Editor. Wechseln Sie zu Diagramm für ein schnelles Bild, oder exportieren Sie es als CSV oder Parquet. Die Symbolleiste über dem Editor enthält Ausführen, Formatieren und EXPLAIN.
Ein Tastenkürzel, das sich lohnt: Klicken Sie in der Seitenleiste auf die Play-Schaltfläche neben einer Tabelle, um ein fertiges SELECT * … LIMIT 100 zu erhalten, oder auf einen Spaltennamen, um nur diese Spalte auszuwählen.
Wie es weitergeht
- Ihre ersten 10 Minuten — eine geführte Tour mit Beispieldaten
- Datenquellen — Formate, Ordner, Muster, Datenbanken, Finder und Quick Look
- SQL-Editor — Tabs, Tastenkürzel, Autovervollständigung, EXPLAIN
- Ergebnisse und Diagramme — Filtern, Exportieren, Diagramme, die Spaltenübersicht
- Dashboards (.dash) — Dashboards als Textdateien und ihre Prüfung mit einem KI-Agenten
- Fehlerbehebung — wenn etwas nicht wie erwartet funktioniert
