---
title: DuckLocal — DuckDB-Desktop-App für SQL auf lokalen Dateien
description: CSV-, Parquet-, JSON- und Excel-Dateien lokal mit DuckDB SQL abfragen. Kein Server, kein Upload, kein Konto, keine Telemetrie.
image: https://ducklocal.app/og-image.jpg?v=2
language: de
---

# DuckLocal

CSV-, Parquet-, JSON- und Excel-Dateien mit DuckDB abfragen, direkt dort, wo sie auf Ihrem Rechner liegen. Kein Server, kein Upload, kein Konto.

DuckLocal ist eine kostenlose Open-Source-Desktop-App für Mac, Windows und Linux, lizenziert unter Apache-2.0.

## Ihr Agent im Terminal, Ihre Daten in DuckLocal

Ihr Agent schreibt eine `.dash`-Datei. Sie prüfen sie in DuckLocal und kommentieren direkt am Diagramm.

- `ducklocal schema` listet jede Datei, jede Tabelle und jede Spalte. `--stats` ergänzt exakte Statistiken pro Spalte.
- `ducklocal query` nimmt eine SQL-Anweisung und gibt begrenztes JSON zurück. Ein abgeschnittenes Ergebnis sagt das selbst.
- `ducklocal open` schickt eine Abfrage oder ein Dashboard ins geöffnete Fenster. `--state` liest zurück, was Sie sehen.
- `ducklocal check` prüft eine `.dash`-Datei, bevor Sie sie sehen. Dashboards lassen sich wie Code diffen und committen.
- `ducklocal comments` lässt den Agenten ein Diagramm bearbeiten, das Sie kommentiert haben, antworten und den Thread abschließen.
- `ducklocal presence` zeigt im Fenster, welches Diagramm der Agent gerade liest oder bearbeitet.

```bash
ducklocal schema ./data/
ducklocal query --sql "SELECT count(*) FROM 'sales.csv'"
```

Ihr Agent in drei Schritten:

1. Öffnen Sie in DuckLocal **Command line & AI…** und klicken Sie auf **Install command**, damit `ducklocal` in Ihrem PATH liegt.
2. Klicken Sie auf **Add to Claude Code**, um den offiziellen Skill zu installieren. Bei Codex oder Cursor klicken Sie auf **Copy brief** und fügen ihn ein.
3. Geben Sie die Aufgabe im Terminal an Ihren Agenten und prüfen Sie das Ergebnis danach in DuckLocal mit einem Kommentar.

Die Demo auf der Startseite wird aus der 224 Zeilen großen Beispieldatei `sales.csv` des Tutorials berechnet. Die Website schickt keine KI-Anfragen, und ein Kommentar startet nie von selbst einen Agenten.

Lesen Sie [SQL für AI-Agenten](https://ducklocal.app/de/use-cases/ai-agent-sql/), die [CLI-Referenz](https://ducklocal.app/docs/de/cli) und die [Dashboard-Anleitung](https://ducklocal.app/docs/de/dashboards).

## Von der Datei zur Antwort

1. **Datei ablegen.** Ziehen Sie eine CSV-Datei, eine Tabelle oder einen ganzen Ordner hinein. Einen Importschritt gibt es nicht.
2. **Schon eine Tabelle.** `sales.csv` wird zur Tabelle `sales`, die Spalten stehen in der Sidebar. Die Datei wird nie kopiert oder verändert.
3. **Mit SQL fragen.** ⌘↵ liefert die Antwort; danach lässt sich das Ergebnis als Diagramm zeigen oder als CSV bzw. Parquet speichern.

```sql
SELECT channel, round(sum(revenue), 2) AS revenue
FROM sales
GROUP BY channel
ORDER BY revenue DESC;
```

DuckLocal öffnet CSV, TSV, Parquet, JSON und NDJSON, Excel- und OpenDocument-Tabellen, DuckDB-Datenbanken, ganze Ordner und S3-Storage, alles dort, wo es liegt.

## Nach der ersten Antwort

- Profilieren Sie eine Abfrage und sehen Sie, welcher Schritt die Zeit gebraucht hat.
- Sehen Sie die Nulls, die verschiedenen Werte und die Spannweite jeder Spalte in einem Ergebnis.
- Hängen Sie weitere DuckDB- oder SQLite-Datenbanken an und verwalten Sie Erweiterungen in der Sidebar.
- Öffnen Sie auf dem Mac Parquet- und DuckDB-Dateien im Finder oder sehen Sie sie mit Quick Look an.

## Ihre Daten bleiben Ihre

- Dateien werden dort gelesen, wo sie liegen, nie kopiert oder hochgeladen.
- Es gibt kein Konto, keine Telemetrie und keinen Cloud-Dienst.
- Nichts geht online, solange Sie es nicht einschalten.
- Open Source unter Apache-2.0, also jede Zeile zum Nachlesen.

## Häufige Fragen

### Was ist DuckLocal?

Eine kostenlose Open-Source-Desktop-App, mit der Sie die Datendateien auf Ihrem Rechner per SQL abfragen. DuckDB läuft in der App, jede abgelegte Datei ist also eine Tabelle, die Sie abfragen können.

### Lädt DuckLocal meine Daten hoch?

Nein. Dateien werden dort gelesen, wo sie liegen, und nie kopiert, hochgeladen oder verändert. Es gibt kein Konto und keine Telemetrie.

### Welche Dateiformate kann es öffnen?

CSV, TSV, Parquet, JSON und NDJSON, Excel- und OpenDocument-Tabellen, DuckDB-Datenbanken, ganze Ordner sowie Dateien in Amazon S3 oder S3-kompatiblem Storage.

### Auf welchen Systemen läuft es?

macOS 12 oder neuer auf Apple silicon, 64-Bit-Windows 10 oder neuer und x86_64-Linux mit glibc 2.35 oder neuer.

### Wie groß dürfen meine Daten sein?

DuckDB fragt die Dateien direkt ab, ohne sie vorher in die App zu laden. Das Ergebnisraster zeigt bis zu 100.000 Zeilen, Exporte schreiben das vollständige Ergebnis.

### Können AI-Agenten wie Claude Code oder Codex es nutzen?

Ja. Der Befehl ducklocal führt SQL im Terminal aus und gibt JSON aus. Der offizielle Skill bringt einem Agenten bei, das Schema zu prüfen, bevor er abfragt.

## Links

- [DuckLocal herunterladen](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [Erste Schritte](https://ducklocal.app/docs/de/getting-started)
- [Tutorial in 10 Minuten](https://ducklocal.app/docs/de/tutorial)
- [Lokale Datenanalyse](https://ducklocal.app/de/use-cases/local-data-analysis/)
- [DuckDB GUI](https://ducklocal.app/de/use-cases/duckdb-gui/)
- [Parquet-Viewer](https://ducklocal.app/de/use-cases/parquet-viewer/)
- [CSV mit SQL abfragen](https://ducklocal.app/de/use-cases/query-csv-with-sql/)
- [Excel mit SQL abfragen](https://ducklocal.app/de/use-cases/query-excel-with-sql/)
- [JSON mit SQL abfragen](https://ducklocal.app/de/use-cases/query-json-with-sql/)
- [SQL-Dashboards](https://ducklocal.app/de/use-cases/sql-dashboards/)
- [DuckLocal vs DBeaver](https://ducklocal.app/de/compare/ducklocal-vs-dbeaver/)
- [Blog](https://ducklocal.app/de/blog/)
- [Dokumentation](https://ducklocal.app/docs/de/)
- [Quellcode](https://github.com/JetSquirrel/DuckLocal)
- [中文](https://ducklocal.app/zh/)
- [日本語](https://ducklocal.app/ja/)

Source: https://ducklocal.app/de/
