Aller au contenu

Démarrer ​

DuckLocal est une application de bureau pour interroger en SQL les fichiers de données de votre machine. Aucun serveur à lancer, aucune connexion à configurer, aucun compte : vous désignez des fichiers et vous commencez à interroger. Cette page vous mène du téléchargement à votre premier résultat en cinq minutes environ.

1. Installer ​

DuckLocal fonctionne sur macOS, Windows et Linux. Les liens ci-dessous téléchargent la dernière version depuis dl.ducklocal.app ; les mêmes fichiers et les notes de version sont disponibles sur GitHub.

Ces guides sont à jour pour la v0.4.1, publiée le 15 novembre 2026. La version 0.4.0 a ajouté les flux de travail d'agent : SQL restreint, transfert contrôlé vers la fenêtre, propositions de tableau de bord, enregistrements d'analyse et projets portables. La version 0.4.1 ajoute les filtres à sélection multiple, un fuseau horaire et un graphique timeline pour les tableaux de bord, des blocs view qui portent une fois du SQL partagé, les extensions communautaires comme mssql dans l'onglet Extensions, et une invite d'enregistrement pour les tables créées dans la base en mémoire. Si vous mettez à jour depuis une version antérieure à 0.3.0, réinstallez vos extensions : cette version a fait passer DuckLocal à DuckDB 2.0.

Mac ​

Il vous faut macOS 12 ou version ultérieure sur Apple silicon (M1 ou plus récent).

  1. Téléchargez ducklocal-macos-arm64.dmg.
  2. Ouvrez-le et faites glisser DuckLocal sur Applications.
  3. Lancez DuckLocal depuis Applications ou Spotlight.

L'image disque est signée et notarisée par Apple, elle s'ouvre donc sans contournement de Gatekeeper.

Windows ​

Il vous faut Windows 10 64 bits ou version ultérieure.

  1. Téléchargez ducklocal-windows-x86_64.zip et extrayez-le.
  2. Lancez ducklocal.exe depuis le dossier extrait. La compilation n'est pas encore signée, le premier lancement peut donc afficher Windows a protégé votre PC — choisissez Informations complémentaires, puis Exécuter quand même.

Linux ​

Il vous faut un système x86_64 avec glibc 2.35 ou version ultérieure (Ubuntu 22.04, Debian 12, Fedora 36 ou plus récent) et des pilotes graphiques compatibles Vulkan.

bash
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/ducklocal
Compiler depuis les sources à la place

Il vous faut Rust stable 1.85.1 ou version ultérieure et une chaîne d'outils C++ (Xcode Command Line Tools). DuckDB est compilé à partir des sources fournies, la première compilation prend donc plusieurs minutes et quelques gigaoctets de disque.

bash
git clone https://github.com/JetSquirrel/DuckLocal
cd DuckLocal
cargo build --release
./target/release/ducklocal

Le binaire est ./target/release/ducklocal ; utilisez-le partout où ce guide indique ducklocal. Voir Développement pour créer un .app.

2. Ajouter la commande ducklocal (facultatif) ​

Tout fonctionne dans l'application sans terminal. Si vous voulez aussi ouvrir des données en ligne de commande — ou laisser un agent IA les analyser avec la CLI — ajoutez la commande depuis l'application :

  1. Cliquez sur le bouton robot dans la barre de titre, ou choisissez DuckLocal → Ligne de commande et IA… dans la barre de menus.
  2. Cliquez sur Installer la commande. Sur un Mac, le système demande votre mot de passe pour écrire dans /usr/local/bin.
  3. Ouvrez un nouveau terminal et vérifiez : ducklocal --version.

La commande est un lien vers l'application, mettre à jour DuckLocal met donc aussi à jour la commande. Pour mettre à jour, cliquez sur la version à l'extrémité droite de la barre d'état : une version plus récente se télécharge et s'installe au redémarrage (voir Recherche de mise à jour). Elle va dans /usr/local/bin sur un Mac et dans ~/.local/bin sur Linux ; sur Windows, le dossier de l'application est ajouté à votre Path.

Dans la même boîte de dialogue, Ajouter à Claude Code installe la compétence DuckLocal pour que Claude Code sache interroger vos fichiers, et Copier le résumé copie une courte explication à coller dans n'importe quel autre agent IA. Voir CLI IA et compétence officielle.

L'ajouter à la main
bash
sudo mkdir -p /usr/local/bin
sudo ln -sf /Applications/DuckLocal.app/Contents/MacOS/ducklocal /usr/local/bin/ducklocal

Pour la supprimer : sudo rm /usr/local/bin/ducklocal. Sur Linux, liez le binaire extrait dans ~/.local/bin ; sur Windows, ajoutez le dossier extrait à votre Path.

3. Ouvrir des données ​

Le premier lancement commence par un court guide, mené par le canard : amener votre agent IA, ouvrir des données, la barre latérale, exécuter une requête et lire ses résultats. Ignorer le ferme à n'importe quelle étape. Pour le revoir, choisissez Afficher le guide dans le menu DuckLocal sur un Mac, ou dans le menu contextuel de la version à l'extrémité droite de la barre d'état.

Derrière ce guide, un écran intitulé Déposez vos données ici. De là, chacun de ces gestes fait entrer des données :

  • Faites glisser des fichiers CSV, TSV, Parquet, JSON ou Excel — ou un dossier entier — sur la fenêtre.

  • Cliquez sur Ouvrir des fichiers ou Ouvrir un dossier.

  • Sur un Mac, double-cliquez sur un fichier .parquet ou .duckdb dans le Finder, ou choisissez DuckLocal dans Ouvrir avec pour les fichiers CSV, JSON et Excel. Voir Ouvrir depuis le Finder.

  • Depuis un terminal, nommez les chemins :

    bash
    ducklocal ./sales.csv         # un fichier
    ducklocal ./logs/             # tous les fichiers de données d'un dossier, récursivement
    ducklocal './data/*.parquet'  # un motif — mettez-le entre guillemets pour que le shell ne l'étende pas d'abord
    ducklocal warehouse.duckdb    # une base DuckDB existante

Chaque fichier devient une vue nommée d'après le fichier — sales.csv devient sales — et apparaît sous Fichiers locaux dans la barre latérale avec ses colonnes et son nombre de lignes. DuckLocal lit les fichiers là où ils se trouvent ; rien n'est copié ni envoyé.

Les fichiers que vous ouvrez sont mémorisés, le prochain lancement démarre donc avec le même espace de travail. Sources de données détaille les formats, les dossiers, les motifs et les bases de données.

Sur un Mac, vous pouvez aussi jeter un œil à un fichier avant de l'ouvrir : sélectionnez-le dans le Finder et appuyez sur Espace. L'aperçu Quick Look de DuckLocal affiche les colonnes et les premières lignes des fichiers Parquet, DuckDB, CSV, TSV et JSON Lines.

Pas de données sous la main ?

Le tutoriel des 10 premières minutes déroule pas à pas un petit fichier d'exemple.

4. Exécuter une requête ​

Cliquez sur Nouvelle requête (ou ouvrez des données — l'éditeur apparaît de lui-même). Saisissez du SQL et appuyez sur ⌘↵ (Cmd+Enter ; Ctrl+Enter sous Windows et Linux) :

sql
SELECT * FROM sales LIMIT 20;

Remplacez sales par n'importe quel nom de vue de votre barre latérale.

Le résultat apparaît dans le panneau sous l'éditeur. Passez-le en Graphique pour un aperçu rapide, ou exportez-le en CSV ou en Parquet. La barre d'outils au-dessus de l'éditeur contient Exécuter, Formater et EXPLAIN.

Un raccourci utile : dans la barre latérale, cliquez sur le bouton de lecture à côté d'une table pour obtenir un SELECT * … LIMIT 100 tout prêt, ou sur un nom de colonne pour ne sélectionner que cette colonne.

Où aller ensuite ​

Publié sous licence Apache-2.0.