Primeros pasos
DuckLocal es una app de escritorio para hacer preguntas con SQL a los archivos de datos de tu máquina. No hay ningún servidor que ejecutar, ni conexión que configurar, ni cuenta: apuntas a tus archivos y empiezas a consultar. Esta página te lleva de la descarga a tu primer resultado en unos cinco minutos.
1. Instala
DuckLocal funciona en macOS, Windows y Linux. Los enlaces de abajo descargan la última versión desde dl.ducklocal.app; los mismos archivos y notas de la versión están en GitHub.
Estas guías están actualizadas para v0.4.1, publicada el 15 de noviembre de 2026. La versión 0.4.0 añadió flujos de trabajo de agentes: SQL restringido, un traspaso verificado a la ventana, propuestas de paneles, registros de análisis y proyectos portables. La versión 0.4.1 añade filtros de selección múltiple, una zona horaria y un gráfico de línea de tiempo para los paneles, bloques view que guardan el SQL compartido una sola vez, extensiones de la comunidad como mssql en la pestaña Extensiones, y un aviso para guardar las tablas creadas en la base de datos en memoria. Si actualizas desde una versión anterior a la 0.3.0, reinstala tus extensiones: esa versión movió DuckLocal a DuckDB 2.0.
Mac
Necesitas macOS 12 o posterior en Apple silicon (M1 o más reciente).
- Descarga
ducklocal-macos-arm64.dmg. - Ábrelo y arrastra DuckLocal a Aplicaciones.
- Inicia DuckLocal desde Aplicaciones o Spotlight.
La imagen de disco está firmada y notarizada por Apple, así que se abre sin ningún rodeo para saltarse Gatekeeper.
Windows
Necesitas Windows 10 de 64 bits o posterior.
- Descarga
ducklocal-windows-x86_64.zipy extráelo. - Ejecuta
ducklocal.exedesde la carpeta extraída. La compilación aún no tiene firma de código, así que el primer inicio puede mostrar Windows protegió tu PC: elige Más información y luego Ejecutar de todas formas.
Linux
Necesitas un sistema x86_64 con glibc 2.35 o posterior (Ubuntu 22.04, Debian 12, Fedora 36 o posterior) y controladores gráficos con soporte de Vulkan.
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/ducklocalCompilar desde el código fuente
Necesitas Rust estable 1.85.1 o posterior y una cadena de herramientas de C++ (Xcode Command Line Tools). DuckDB se compila desde fuentes incluidas, así que la primera compilación tarda varios minutos y unos cuantos gigabytes de disco.
git clone https://github.com/JetSquirrel/DuckLocal
cd DuckLocal
cargo build --release
./target/release/ducklocalEl binario es ./target/release/ducklocal; úsalo donde esta guía dice ducklocal. Consulta Desarrollo para empaquetar un .app.
2. Añade el comando ducklocal (opcional)
Todo en la app funciona sin terminal. Si además quieres abrir datos desde la línea de comandos — o dejar que un agente de IA los analice con la CLI — añade el comando desde la app:
- Haz clic en el botón del robot de la barra de título, o elige DuckLocal → Línea de comandos e IA… en la barra de menús.
- Haz clic en Instalar comando. En un Mac, el sistema te pide tu contraseña para escribir en
/usr/local/bin. - Abre un terminal nuevo y compruébalo:
ducklocal --version.
El comando es un enlace a la app, así que actualizar DuckLocal actualiza también el comando. Para actualizar, haz clic en la versión del extremo derecho de la barra de estado: una versión más reciente se descarga y se instala al reiniciar (consulta Comprobación de actualizaciones). Se coloca en /usr/local/bin en un Mac y en ~/.local/bin en Linux; en Windows, la carpeta de la app se añade a tu Path.
En el mismo diálogo, Añadir a Claude Code instala la habilidad de DuckLocal para que Claude Code sepa consultar tus archivos, y Copiar resumen copia una explicación breve para pegarla en cualquier otro agente de IA. Consulta CLI de IA y habilidad oficial.
Añadirlo a mano
sudo mkdir -p /usr/local/bin
sudo ln -sf /Applications/DuckLocal.app/Contents/MacOS/ducklocal /usr/local/bin/ducklocalPara quitarlo: sudo rm /usr/local/bin/ducklocal. En Linux, enlaza el binario extraído en ~/.local/bin; en Windows, añade la carpeta extraída a tu Path.
3. Abre algunos datos
El primer inicio arranca con una guía breve, dirigida por el pato: traer tu agente de IA, abrir datos, la barra lateral, ejecutar una consulta y leer sus resultados. Omitir la cierra en cualquier paso. Para volver a verla, elige Mostrar la guía en el menú DuckLocal de un Mac, o en el menú contextual de la versión del extremo derecho de la barra de estado.
Detrás hay una pantalla titulada Suelta tus datos aquí. Desde aquí, cualquiera de estas acciones trae datos:
Arrastra archivos CSV, TSV, Parquet, JSON o Excel — o una carpeta entera — a la ventana.
Haz clic en Abrir archivos o Abrir carpeta.
En un Mac, haz doble clic en un archivo
.parqueto.duckdben Finder, o elige DuckLocal en Abrir con para archivos CSV, JSON y Excel. Consulta Abrir desde Finder.Desde un terminal, indica las rutas:
bashducklocal ./sales.csv # un archivo ducklocal ./logs/ # todos los archivos de datos de una carpeta, de forma recursiva ducklocal './data/*.parquet' # un patrón: entre comillas para que el shell no lo expanda antes ducklocal warehouse.duckdb # una base de datos DuckDB existente
Cada archivo se convierte en una vista con el nombre del archivo —sales.csv pasa a ser sales— y aparece en Archivos locales de la barra lateral con sus columnas y su recuento de filas. DuckLocal lee los archivos donde están; no se copia ni se sube nada.
Los archivos que abres se recuerdan, así que el siguiente inicio continúa con el mismo espacio de trabajo. Fuentes de datos tiene los detalles sobre formatos, carpetas, patrones y bases de datos.
En un Mac también puedes echar un vistazo a un archivo antes de abrirlo: selecciónalo en Finder y pulsa Espacio. La vista previa de Quick Look de DuckLocal muestra las columnas y las primeras filas de archivos Parquet, DuckDB, CSV, TSV y JSON Lines.
¿No tienes datos a mano?
El tutorial de los primeros 10 minutos recorre paso a paso un archivo de ejemplo pequeño.
4. Ejecuta una consulta
Haz clic en Nueva consulta (o abre algunos datos: el editor aparece solo). Escribe SQL y pulsa ⌘↵ (Cmd+Enter; Ctrl+Enter en Windows y Linux):
SELECT * FROM sales LIMIT 20;Sustituye sales por cualquier nombre de vista de tu barra lateral.
El resultado aparece en el panel que hay bajo el editor. Cámbialo a Gráfico para ver una imagen rápida, o expórtalo como CSV o Parquet. La barra de herramientas sobre el editor tiene Ejecutar, Formato y EXPLAIN.
Un atajo que conviene conocer: en la barra lateral, haz clic en el botón de reproducción junto a una tabla para obtener un SELECT * … LIMIT 100 ya hecho, o en el nombre de una columna para seleccionar solo esa columna.
A dónde ir ahora
- Tus primeros 10 minutos — un recorrido guiado con datos de ejemplo
- Fuentes de datos — formatos, carpetas, patrones, bases de datos, Finder y Quick Look
- Editor SQL — pestañas, atajos, autocompletado, EXPLAIN
- Resultados y gráficos — filtrado, exportación, gráficos, el resumen de columnas
- Paneles (.dash) — paneles como archivos de texto y cómo revisarlos con un agente de IA
- Solución de problemas — cuando algo no se comporta como esperas
