---
title: "DuckDB UI vs DuckLocal: qué interfaz local de DuckDB usar"
description: "DuckDB UI es un notebook de navegador; DuckLocal es un espacio de trabajo de escritorio. En qué se diferencian, cuándo elegir DuckDB UI y cómo ejecutarlo dentro de DuckLocal con CALL start_ui()."
language: "es"
---

# DuckDB UI vs DuckLocal: ¿cuál deberías usar?

Los dos ponen una interfaz local sobre DuckDB. Uno es un notebook de navegador que cualquier proceso de DuckDB puede abrir; el otro es un espacio de trabajo de escritorio construido en torno a tus archivos. Responden a necesidades distintas, y puedes ejecutar uno dentro del otro.

![DuckDB UI vs DuckLocal, con el pato de DuckLocal frente a un portátil](https://ducklocal.app/assets/blog/duckdb-ui-vs-ducklocal-cover.webp)

En marzo de 2025, DuckDB 1.2.1 llegó junto con DuckDB UI: ejecuta `duckdb -ui` y se abre un notebook en tu navegador, respaldado por el proceso de DuckDB que corre en tu propia máquina. Desde entonces, la pregunta más frecuente que recibo sobre DuckLocal es alguna versión de *«¿por qué no usar simplemente DuckDB UI?»*

Es una pregunta justa. Las dos herramientas ejecutan DuckDB en local, ninguna necesita un servidor que administres y ambas mantienen tus consultas y tus datos en tu computadora. Pero parten de lugares distintos, y esa diferencia decide cuál encaja en cada trabajo. Este artículo es mi intento honesto de explicarlo, incluidos los casos en los que yo mismo recurriría a DuckDB UI.

## 1. La respuesta breve

| Si… | Usa |
| --- | --- |
| ya trabajas con la CLI de DuckDB o con Python y quieres una vista visual de esa sesión | DuckDB UI |
| piensas en notebooks de celdas SQL | DuckDB UI |
| usas MotherDuck o quieres compartir resultados a través de él | DuckDB UI |
| partes de un montón de archivos y carpetas CSV, Parquet, JSON o Excel | DuckLocal |
| necesitas trabajar sin conexión o quieres que cada parte de la herramienta esté instalada y sea revisable | DuckLocal |
| quieres gráficos y paneles que puedas guardar como archivos y mantener en git | DuckLocal |
| quieres que un agente de IA consulte los mismos datos desde una terminal | DuckLocal |
| quieres los dos sobre los mismos datos | DuckLocal y luego `CALL start_ui();` |

## 2. Qué es DuckDB UI

DuckDB UI lo desarrolla y mantiene MotherDuck y se distribuye como una extensión de DuckDB llamada `ui`. La inicias con `duckdb -ui` desde la terminal, o con `CALL start_ui();` desde cualquier cliente de DuckDB: la CLI, Python, Java, etc.

La extensión levanta un servidor HTTP en `localhost` (puerto 4213 por defecto) dentro del proceso de DuckDB que la ha llamado y abre tu navegador. Como la UI habla con ese mismo proceso, ve todo lo que ve el proceso: sus bases de datos adjuntas, su memoria y tus archivos locales.

Esto es lo que obtienes en el navegador:

- **Notebooks**: colecciones de celdas SQL con nombre y guardadas, con resaltado de sintaxis y autocompletado. Una celda puede contener varias sentencias.

- **Un explorador de bases de datos adjuntas** con un resumen de tabla: número de filas, columnas, tipos y un perfil por columna.

- **Un Column Explorer** que resume un resultado y te permite profundizar en cada columna.

- **Inicio de sesión opcional en MotherDuck**, para guardar tablas en el almacén en la nube de MotherDuck y compartirlas. Es opcional; por defecto nada sale de tu máquina.

Dos detalles importan para la comparación. Primero, el servidor local de la extensión **descarga los archivos del frontend de la propia UI desde `https://ui.duckdb.org`** para que la interfaz se mantenga al día; tus consultas se siguen ejecutando en local, pero la UI se carga desde la red. Cuando se lanzó, no se admitía su uso sin conexión. Segundo, la extensión tiene licencia MIT, mientras que en el lanzamiento el código del frontend no estaba publicado.

Fuentes: [anuncio de DuckDB UI](https://duckdb.org/2025/03/12/duckdb-ui) · [documentación de la extensión UI](https://duckdb.org/docs/current/core_extensions/ui.html) · [duckdb/duckdb-ui en GitHub](https://github.com/duckdb/duckdb-ui). Consulta esos enlaces para ver los cambios posteriores a la publicación de este artículo.

## 3. Comparación lado a lado

| Dimensión | DuckDB UI | DuckLocal |
| --- | --- | --- |
| Qué es | Un notebook de navegador servido por la extensión `ui` de DuckDB | Una aplicación de escritorio nativa con DuckDB integrado |
| Cómo se inicia | `duckdb -ui` o `CALL start_ui();` desde cualquier cliente de DuckDB (1.2.1 o posterior) | Abrir la aplicación o ejecutar `ducklocal ./data/` |
| Dónde se ejecutan las consultas | En el proceso de DuckDB que la inició, en tu máquina | En el DuckDB integrado en DuckLocal, en tu máquina |
| Archivos de la interfaz | El servidor local los descarga de `ui.duckdb.org` | Vienen con la aplicación |
| Sin conexión | Necesita red para los archivos de la UI | Funciona sin conexión; la red solo se usa para S3, teselas de mapa, instalación de extensiones y las comprobaciones de actualización que actives |
| Cómo incorporar datos | SQL: `read_csv`, `ATTACH` o lo que ya tenga la sesión | Arrastra archivos, carpetas y patrones glob; se convierten en vistas y siguen ahí en el siguiente arranque |
| Forma de trabajar | Notebooks de celdas SQL | Pestañas de consulta, una barra lateral de esquema, historial, `EXPLAIN` y un generador de perfiles |
| Explorar resultados | Resúmenes de tabla y el Column Explorer | Cuadrícula de resultados, una pestaña Resumen por columna y gráficos integrados |
| Reutilización y uso compartido | Notebooks guardados; uso compartido opcional con MotherDuck | Paneles `.dash` en texto plano que puedes revisar y mantener en git, con comentarios en los gráficos |
| Agentes de IA | No es su objetivo | CLI `ducklocal` con JSON acotado y una habilidad de agente oficial |
| Código fuente | Extensión con licencia MIT; frontend no publicado en el lanzamiento | Apache-2.0, aplicación y código en GitHub |
| Plataformas | Donde se ejecute DuckDB, excepto `windows_arm64` | macOS en Apple silicon, Windows x64, Linux x86_64 |

La forma más breve de decirlo: **DuckDB UI es una ventana a una sesión de DuckDB que ya tienes. DuckLocal es la sesión, construida en torno a los archivos que quieres mirar.**

## 4. Cuándo usar DuckDB UI

### Ya vives en DuckDB

Si tu trabajo ocurre en la CLI de DuckDB o en un script de Python, la UI está a un comando de distancia y no requiere una aplicación nueva. Ejecuta `duckdb -ui my.duckdb`, o llama a `start_ui()` desde el proceso de Python que ya cargó y transformó tus datos, y estarás viendo exactamente ese estado. DuckLocal no puede ver dentro de otro proceso; la UI está diseñada para hacerlo.

### Piensas en notebooks

Algunos análisis son una larga secuencia de pasos que quieres mantener en orden: cargar, limpiar, unir, comprobar, resumir. Los notebooks con celdas con nombre y guardadas encajan bien con eso, y una celda puede ejecutar varias sentencias a la vez. Las pestañas de consulta de DuckLocal sirven más para hacer muchas preguntas separadas que para mantener una narración larga.

### Usas MotherDuck

Si tu equipo ya comparte datos a través de MotherDuck, la UI es el front end natural: inicia sesión y el mismo notebook llega tanto al DuckDB local como a tu almacén en la nube. DuckLocal no tiene servicio en la nube y no planea tenerlo.

### DuckLocal no tiene compilación para tu máquina

DuckLocal se distribuye para macOS en Apple silicon, Windows x64 y Linux x86_64. En un Mac con Intel, por ejemplo, tendrías que compilar DuckLocal desde el código fuente, mientras que DuckDB UI se ejecuta donde se ejecuta DuckDB (excepto Windows en ARM).

## 5. Cuándo usar DuckLocal

### Empiezas por archivos, no por SQL

Arrastra un CSV, una carpeta de archivos Parquet o un patrón como `./logs/2026-*/*.json`, y cada uno se convierte en una vista que puedes consultar, con sus columnas en la barra lateral. Cada hoja no vacía de un libro de Excel se convierte en una tabla. No hace falta escribir `read_csv(…)` primero, y los archivos siguen ahí la próxima vez que abras la aplicación.

### Necesitas que funcione sin conexión o que sea totalmente revisable

La interfaz de DuckLocal forma parte de la aplicación que instalaste. No carga código de interfaz en tiempo de ejecución, no descarga extensiones por su cuenta y las comprobaciones de actualización están desactivadas hasta que las actives. El frontend de DuckDB UI, en cambio, se descarga cuando arranca la UI, y puede leer los datos cargados en DuckDB; la propia documentación de DuckDB aconseja apuntarlo solo a una URL de confianza. Para la mayoría de la gente eso está bien. Para revisiones de seguridad, auditorías, datos regulados o máquinas aisladas de la red, «todo está instalado y es de código abierto» es una garantía más fuerte.

### Quieres gráficos y paneles como archivos

Los resultados se convierten en gráficos de barras, de líneas, de dispersión, circulares y de mapa en el mismo sitio. Cuando una vista merece conservarse, un [archivo `.dash`](https://ducklocal.app/docs/es/dashboards) describe sus consultas, gráficos y filtros en texto plano: algo que puedes comparar con diff, revisar en un pull request y validar con `ducklocal check`.

### Trabajas con un agente de IA

La [CLI `ducklocal`](https://ducklocal.app/es/use-cases/ai-agent-sql/) da al agente un flujo de trabajo SQL que empieza por el esquema, de una sola sentencia, con salida JSON acotada, y los comentarios de los paneles te permiten plantearle una pregunta sobre un gráfico concreto. Los mismos archivos están abiertos en la aplicación para que compruebes su trabajo.

## 6. Ejecutar DuckDB UI dentro de DuckLocal

No tienes que elegir. DuckDB UI es una extensión, y DuckLocal puede cargar extensiones de DuckDB, así que la UI se ejecuta encima de la propia instancia de DuckDB de DuckLocal:

- Abre la pestaña **Extensiones** en la barra lateral de DuckLocal.

- Pulsa **Instalar** en la fila `ui` y luego **Cargar**. DuckLocal nunca instala extensiones por su cuenta, así que este paso es deliberado.

- En una pestaña de consulta, ejecuta:

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

Tu navegador abre DuckDB UI en `http://localhost:4213`. Está conectada a la instancia de DuckDB que ejecuta DuckLocal, así que los archivos que abriste en DuckLocal están ahí para usarlos en un notebook.

![Pestaña Extensiones de DuckLocal con la extensión ui marcada como Cargada, junto a la pantalla de inicio «Arrastra aquí tus datos»](https://ducklocal.app/assets/blog/ducklocal-extensions-ui.webp)

*La extensión `ui` cargada en la pestaña Extensiones de DuckLocal. Desde aquí, `CALL start_ui();` abre DuckDB UI sobre la misma instancia de DuckDB.*

Algunas cosas que conviene saber:

- **Necesita la red:** una vez para instalar `ui` y cada vez que arranca, para descargar los archivos de la UI desde `ui.duckdb.org`.

- **Termina con DuckLocal.** Al salir de DuckLocal se cierra su instancia de DuckDB y con ella el servidor de la UI. `CALL stop_ui_server();` lo detiene antes, y `CALL start_ui_server();` lo inicia sin abrir un navegador.

- **Los notebooks son de la extensión** y se guardan en `~/.duckdb/extension_data/ui/`. El historial de consultas de DuckLocal no incluye lo que ejecutas en la UI.

- **No puede ejecutarse directamente sobre una base de datos de solo lectura.** Conecta esa base de datos desde un notebook con `ATTACH '…' (READ_ONLY)`.

Así es como las uso juntas: DuckLocal para abrir los datos, mirar las columnas y graficar las preguntas obvias; DuckDB UI cuando una pregunta se convierte en una investigación más larga que quiero guardar como notebook.

Documentación: [Abrir DuckDB UI desde DuckLocal](https://ducklocal.app/docs/es/schema-and-history#duckdb-ui) · [Pestaña Extensiones](https://ducklocal.app/docs/es/schema-and-history#extensions)

## 7. Preguntas frecuentes

### ¿Cuál es la diferencia entre DuckDB UI y DuckLocal?

DuckDB UI es un notebook de navegador que la extensión `ui` de DuckDB sirve desde el proceso de DuckDB que lo inicia. DuckLocal es una aplicación de escritorio nativa con DuckDB integrado, pensada para abrir archivos y carpetas, gráficos, paneles en texto plano y una CLI para agentes de IA. Los dos ejecutan las consultas en local.

### ¿DuckLocal sustituye a DuckDB UI?

No. Coinciden en ejecutar SQL sobre datos locales, pero la UI funciona mejor como ventana a una sesión de DuckDB existente y DuckLocal como espacio de trabajo para archivos. Como la UI se ejecuta dentro de DuckLocal, puedes usar las dos.

### ¿Funciona DuckDB UI sin conexión?

Tus consultas se ejecutan en local, pero los archivos del frontend de la UI se descargan de `ui.duckdb.org` cada vez que arranca, así que necesita acceso a la red. La interfaz de DuckLocal viene con la aplicación y funciona sin conexión.

### ¿Mis consultas van a MotherDuck?

No, salvo que inicies sesión en MotherDuck dentro de la UI. Por defecto, DuckDB UI ejecuta tus consultas en tu propia máquina, igual que DuckLocal.

## Enlaces relacionados

- [La UI local de DuckDB (blog de DuckDB)](https://duckdb.org/2025/03/12/duckdb-ui)

- [Documentación de la extensión UI](https://duckdb.org/docs/current/core_extensions/ui.html)

- [Análisis de datos local con DuckLocal](https://ducklocal.app/es/use-cases/local-data-analysis/)

- [Lo que Claude Dashboards me enseñó sobre DuckLocal](https://ducklocal.app/es/blog/claude-dashboards-ducklocal/)

[← Todas las entradas](https://ducklocal.app/es/blog/)

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