# Démarrer

> Installez DuckLocal sur macOS, Windows ou Linux, ajoutez la CLI ducklocal, ouvrez un fichier CSV, Parquet, JSON ou Excel et exécutez votre première requête SQL DuckDB.

Source: https://ducklocal.app/docs/fr/getting-started

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 {#install}

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](https://github.com/JetSquirrel/DuckLocal/releases/latest).

Ces guides sont à jour pour la [v0.4.1](https://github.com/JetSquirrel/DuckLocal/releases/tag/v0.4.1), publiée le 15 novembre 2026. La version 0.4.0 a ajouté les [flux de travail d'agent](agent-workflows.md) : 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`](https://dl.ducklocal.app/latest/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`](https://dl.ducklocal.app/latest/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
```

::: details 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](development.md) pour créer un `.app`.
:::

## 2. Ajouter la commande `ducklocal` (facultatif) {#add-command}

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](cli.md) — 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](settings-and-data.md#update-check)). 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](cli.md#install-the-official-skill).

::: details 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](data-sources.md#open-from-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](data-sources.md) 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](data-sources.md#quick-look)
de DuckLocal affiche les colonnes et les premières lignes des fichiers Parquet,
DuckDB, CSV, TSV et JSON Lines.

::: tip Pas de données sous la main ?
Le [tutoriel des 10 premières minutes](tutorial.md) 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

- [Vos 10 premières minutes](tutorial.md) — une visite guidée avec des données d'exemple
- [Sources de données](data-sources.md) — formats, dossiers, motifs, bases de données, Finder et Quick Look
- [Éditeur SQL](sql-editor.md) — onglets, raccourcis, autocomplétion, EXPLAIN
- [Résultats et graphiques](results-and-charts.md) — filtrage, export, graphiques, vue d'ensemble des colonnes
- [Tableaux de bord (.dash)](dashboards.md) — les tableaux de bord comme fichiers texte, et leur revue par un agent IA
- [Dépannage](troubleshooting.md) — quand quelque chose ne se comporte pas comme prévu
