---
title: "DuckDB UI ou DuckLocal : quelle interface choisir ?"
description: "DuckDB UI est un notebook dans le navigateur, DuckLocal un espace de travail de bureau. Différences, quand choisir DuckDB UI et comment l’ouvrir dans DuckLocal."
language: "fr"
---

# DuckDB UI ou DuckLocal : laquelle choisir ?

Les deux posent une interface locale sur DuckDB. L’une est un notebook dans le navigateur que n’importe quel processus DuckDB peut ouvrir ; l’autre est un espace de travail de bureau construit autour de vos fichiers. Ils répondent à des besoins différents, et l’un peut tourner à l’intérieur de l’autre.

![DuckDB UI face à DuckLocal, avec le canard de DuckLocal devant un ordinateur portable](https://ducklocal.app/assets/blog/duckdb-ui-vs-ducklocal-cover.webp)

En mars 2025, DuckDB 1.2.1 est sorti avec le DuckDB UI : lancez `duckdb -ui` et un notebook s’ouvre dans votre navigateur, adossé au processus DuckDB de votre propre machine. Depuis, la question qu’on me pose le plus souvent à propos de DuckLocal est une variante de *« pourquoi ne pas simplement utiliser le DuckDB UI ? »*

C’est une bonne question. Les deux outils font tourner DuckDB en local, aucun des deux ne demande un serveur à administrer, et tous deux gardent vos requêtes et vos données sur votre ordinateur. Mais ils partent d’endroits différents, et cette différence décide lequel convient à un travail donné. Cet article est ma tentative honnête de l’expliquer — y compris les cas où je me tournerais moi-même vers le DuckDB UI.

## 1. La réponse courte

| Si vous… | Utilisez |
| --- | --- |
| travaillez déjà dans le CLI DuckDB ou en Python et voulez une vue visuelle de cette session | DuckDB UI |
| pensez en notebooks de cellules SQL | DuckDB UI |
| utilisez MotherDuck ou voulez partager des résultats par son intermédiaire | DuckDB UI |
| partez d’un tas de fichiers et de dossiers CSV, Parquet, JSON ou Excel | DuckLocal |
| devez travailler hors ligne, ou voulez que chaque partie de l’outil soit installée et vérifiable | DuckLocal |
| voulez des graphiques et des tableaux de bord enregistrables en fichiers et versionnables dans git | DuckLocal |
| voulez qu’un agent IA interroge les mêmes données depuis un terminal | DuckLocal |
| voulez les deux sur les mêmes données | DuckLocal, puis `CALL start_ui();` |

## 2. Ce qu’est DuckDB UI

Le DuckDB UI est développé et maintenu par MotherDuck, et distribué sous forme d’extension DuckDB nommée `ui`. Vous le lancez avec `duckdb -ui` depuis le terminal, ou avec `CALL start_ui();` depuis n’importe quel client DuckDB — le CLI, Python, Java, etc.

L’extension démarre un serveur HTTP sur `localhost` (port 4213 par défaut) à l’intérieur du processus DuckDB qui l’a appelée, puis ouvre votre navigateur. Comme l’interface dialogue avec ce processus même, elle voit tout ce que le processus voit : ses bases attachées, sa mémoire et vos fichiers locaux.

Ce que vous obtenez dans le navigateur :

- **Des notebooks** — des ensembles nommés et enregistrés de cellules SQL, avec coloration syntaxique et autocomplétion. Une cellule peut contenir plusieurs instructions.

- **Un explorateur des bases attachées** avec un résumé des tables : nombre de lignes, colonnes, types et profil par colonne.

- **Un Column Explorer** qui résume un résultat et permet d’explorer chaque colonne.

- **Une connexion MotherDuck facultative**, pour conserver des tables dans l’entrepôt cloud de MotherDuck et les partager. C’est optionnel ; par défaut, rien ne quitte votre machine.

Deux détails comptent pour la comparaison. D’abord, le serveur local de l’extension **récupère les fichiers frontend de l’interface sur `https://ui.duckdb.org`** pour que l’interface reste à jour ; vos requêtes continuent de s’exécuter en local, mais l’interface elle-même est chargée depuis le réseau. L’usage hors ligne n’était pas pris en charge au lancement. Ensuite, l’extension est sous licence MIT, alors qu’au lancement le code source du frontend n’était pas publié.

Sources : [annonce du DuckDB UI](https://duckdb.org/2025/03/12/duckdb-ui) · [documentation de l’extension UI](https://duckdb.org/docs/current/core_extensions/ui.html) · [duckdb/duckdb-ui sur GitHub](https://github.com/duckdb/duckdb-ui). Consultez-les pour les changements survenus après la rédaction de cet article.

## 3. Comparaison point par point

| Critère | DuckDB UI | DuckLocal |
| --- | --- | --- |
| Ce que c’est | Un notebook dans le navigateur, servi par l’extension `ui` de DuckDB | Une application de bureau native avec DuckDB intégré |
| Comment le lancer | `duckdb -ui` ou `CALL start_ui();` depuis n’importe quel client DuckDB (1.2.1 ou plus) | Ouvrez l’application, ou lancez `ducklocal ./data/` |
| Où s’exécutent les requêtes | Dans le processus DuckDB qui l’a lancé, sur votre machine | Dans le DuckDB intégré à DuckLocal, sur votre machine |
| Fichiers de l’interface | Récupérés sur `ui.duckdb.org` par le serveur local | Livrés avec l’application |
| Hors ligne | Nécessite le réseau pour les fichiers de l’interface | Fonctionne hors ligne ; le réseau ne sert qu’à S3, aux tuiles de carte, à l’installation d’extensions et aux vérifications de mise à jour que vous activez |
| Importation des données | SQL : `read_csv`, `ATTACH`, ou ce que la session contient déjà | Glissez des fichiers, des dossiers et des motifs glob ; ils deviennent des vues et sont là au prochain lancement |
| Façon de travailler | Des notebooks de cellules SQL | Des onglets de requête, une barre latérale de schéma, l’historique, `EXPLAIN` et un profileur |
| Exploration des résultats | Résumés de tables et Column Explorer | Grille de résultats, onglet Aperçu par colonne et graphiques intégrés |
| Réutilisation et partage | Notebooks enregistrés ; partage MotherDuck facultatif | Tableaux de bord `.dash` en texte, à relire et à versionner dans git, avec des commentaires sur les graphiques |
| Agents IA | Pas la priorité | CLI `ducklocal` avec du JSON borné et un skill d’agent officiel |
| Source | Extension sous MIT ; frontend non publié au lancement | Apache-2.0, application et source sur GitHub |
| Plateformes | Partout où DuckDB tourne, sauf `windows_arm64` | macOS sur Apple silicon, Windows x64, Linux x86_64 |

La façon la plus courte de le dire : **DuckDB UI est une fenêtre sur une session DuckDB que vous avez déjà. DuckLocal est cette session, construite autour des fichiers que vous voulez regarder.**

## 4. Quand utiliser DuckDB UI

### Vous vivez déjà dans DuckDB

Si votre travail se passe dans le CLI DuckDB ou dans un script Python, l’interface est à une commande et ne demande aucune nouvelle application. Lancez `duckdb -ui my.duckdb`, ou appelez `start_ui()` depuis le processus Python qui a déjà chargé et transformé vos données, et vous regardez exactement cet état. DuckLocal ne peut pas voir à l’intérieur d’un autre processus ; l’interface, elle, est conçue pour cela.

### Vous pensez en notebooks

Certaines analyses forment une longue suite d’étapes que vous voulez garder dans l’ordre : charger, nettoyer, joindre, vérifier, résumer. Les notebooks à cellules nommées et enregistrées s’y prêtent bien, et une cellule peut exécuter plusieurs instructions d’un coup. Les onglets de requête de DuckLocal conviennent mieux à une série de questions séparées qu’à la conservation d’un long récit.

### Vous utilisez MotherDuck

Si votre équipe partage déjà des données via MotherDuck, l’interface en est le frontal naturel : connectez-vous et le même notebook atteint à la fois le DuckDB local et votre entrepôt cloud. DuckLocal n’a pas de service cloud et n’en prévoit pas.

### DuckLocal n’a pas de build pour votre machine

DuckLocal est distribué pour macOS sur Apple silicon, Windows x64 et Linux x86_64. Sur un Mac Intel, par exemple, il faudrait compiler DuckLocal depuis les sources, alors que le DuckDB UI tourne partout où DuckDB tourne (sauf Windows sur ARM).

## 5. Quand utiliser DuckLocal

### Vous partez de fichiers, pas de SQL

Glissez un CSV, un dossier de fichiers Parquet ou un motif comme `./logs/2026-*/*.json`, et chacun devient une vue interrogeable, avec ses colonnes dans la barre latérale. Chaque feuille non vide d’un classeur Excel devient une table. Rien n’a besoin d’être écrit d’abord en `read_csv(…)`, et les fichiers sont toujours là à la prochaine ouverture de l’application.

### Vous avez besoin du hors ligne, ou d’un outil entièrement vérifiable

L’interface de DuckLocal fait partie de l’application que vous avez installée. Elle ne charge aucun code d’interface à l’exécution, ne télécharge pas d’extensions de son propre chef, et les vérifications de mise à jour sont désactivées tant que vous ne les activez pas. Le frontend du DuckDB UI, à l’inverse, est récupéré au démarrage de l’interface, et il peut lire les données chargées dans DuckDB — la documentation de DuckDB conseille elle-même de ne le pointer que vers une URL de confiance. Pour la plupart des gens, cela suffit. Pour les revues de sécurité, les audits, les données réglementées ou les machines isolées, « tout est installé et open source » est une garantie plus forte.

### Vous voulez des graphiques et des tableaux de bord sous forme de fichiers

Les résultats deviennent sur place des graphiques en barres, en lignes, en nuage de points, en secteurs et cartographiques. Quand une vue mérite d’être conservée, un [fichier `.dash`](https://ducklocal.app/docs/fr/dashboards) décrit ses requêtes, ses graphiques et ses filtres en texte — quelque chose que vous pouvez comparer avec un diff, relire dans une pull request et valider avec `ducklocal check`.

### Vous travaillez avec un agent IA

Le [CLI `ducklocal`](https://ducklocal.app/fr/use-cases/ai-agent-sql/) donne à un agent un flux SQL schéma d’abord, une instruction à la fois, avec une sortie JSON bornée, et les commentaires de tableau de bord vous permettent de lui confier une question sur un graphique précis. Les mêmes fichiers sont ouverts dans l’application pour que vous puissiez vérifier son travail.

## 6. Lancer DuckDB UI dans DuckLocal

Vous n’avez pas à choisir. Le DuckDB UI est une extension, et DuckLocal sait charger les extensions DuckDB — l’interface tourne donc au-dessus de l’instance DuckDB de DuckLocal :

- Ouvrez l’onglet **Extensions** dans la barre latérale de DuckLocal.

- Cliquez sur **Installer** sur la ligne `ui`, puis sur **Charger**. DuckLocal n’installe jamais d’extension de lui-même : cette étape est donc volontaire.

- Dans un onglet de requête, exécutez :

```text
CALL start_ui();
```

Votre navigateur ouvre le DuckDB UI à l’adresse `http://localhost:4213`. Il est attaché à l’instance DuckDB que fait tourner DuckLocal, donc les fichiers que vous avez ouverts dans DuckLocal sont là, prêts à servir dans un notebook.

![L’onglet Extensions de DuckLocal avec l’extension ui marquée comme chargée, à côté de l’écran d’accueil « Déposez vos données »](https://ducklocal.app/assets/blog/ducklocal-extensions-ui.webp)

*L’extension `ui` chargée dans l’onglet Extensions de DuckLocal. De là, `CALL start_ui();` ouvre le DuckDB UI sur la même instance DuckDB.*

Quelques points à connaître :

- **Il faut le réseau :** une fois pour installer `ui`, puis à chaque démarrage, pour récupérer les fichiers de l’interface depuis `ui.duckdb.org`.

- **Il s’arrête avec DuckLocal.** Quitter DuckLocal ferme son instance DuckDB et, avec elle, le serveur de l’interface. `CALL stop_ui_server();` l’arrête plus tôt, et `CALL start_ui_server();` le démarre sans ouvrir de navigateur.

- **Les notebooks appartiennent à l’extension,** et sont stockés dans `~/.duckdb/extension_data/ui/`. L’historique de requêtes de DuckLocal n’inclut pas ce que vous exécutez dans l’interface.

- **Il ne peut pas s’exécuter directement sur une base en lecture seule.** Attachez plutôt cette base depuis un notebook avec `ATTACH '…' (READ_ONLY)`.

Voici comment je les utilise ensemble : DuckLocal pour ouvrir les données, regarder les colonnes et graphiquer les questions évidentes ; le DuckDB UI quand une question devient une enquête plus longue que je veux garder sous forme de notebook.

Documentation : [Ouvrir le DuckDB UI depuis DuckLocal](https://ducklocal.app/docs/fr/schema-and-history#duckdb-ui) · [Onglet Extensions](https://ducklocal.app/docs/fr/schema-and-history#extensions)

## 7. FAQ

### Quelle est la différence entre DuckDB UI et DuckLocal ?

DuckDB UI est un notebook dans le navigateur, fourni par l’extension `ui` de DuckDB depuis le processus DuckDB qui le démarre. DuckLocal est une application de bureau native avec DuckDB intégré, construite autour de l’ouverture de fichiers et de dossiers, des graphiques, des tableaux de bord en texte et d’un CLI pour les agents IA. Les deux exécutent les requêtes en local.

### DuckLocal remplace-t-il le DuckDB UI ?

Non. Ils se recoupent sur l’exécution de SQL sur des données locales, mais l’interface est surtout une fenêtre sur une session DuckDB existante, et DuckLocal un espace de travail pour vos fichiers. Comme l’interface tourne dans DuckLocal, vous pouvez utiliser les deux.

### DuckDB UI fonctionne-t-il hors ligne ?

Vos requêtes s’exécutent en local, mais les fichiers frontend de l’interface sont récupérés sur `ui.duckdb.org` à chaque démarrage : un accès réseau est donc nécessaire. L’interface de DuckLocal est livrée avec l’application et fonctionne hors ligne.

### Mes requêtes partent-elles chez MotherDuck ?

Pas à moins que vous ne vous connectiez à MotherDuck dans l’interface. Par défaut, le DuckDB UI exécute vos requêtes sur votre propre machine, comme DuckLocal.

## Liens connexes

- [L’interface locale de DuckDB (blog DuckDB)](https://duckdb.org/2025/03/12/duckdb-ui)

- [Documentation de l’extension UI](https://duckdb.org/docs/current/core_extensions/ui.html)

- [L’analyse de données locale avec DuckLocal](https://ducklocal.app/fr/use-cases/local-data-analysis/)

- [Ce que Claude Dashboards m’a appris sur DuckLocal](https://ducklocal.app/fr/blog/claude-dashboards-ducklocal/)

[← Tous les articles](https://ducklocal.app/fr/blog/)

Source: https://ducklocal.app/fr/blog/duckdb-ui-vs-ducklocal/
