# Primeros pasos

> Instala DuckLocal en macOS, Windows o Linux, añade la CLI ducklocal, abre un archivo CSV, Parquet, JSON o Excel y ejecuta tu primera consulta SQL de DuckDB.

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

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

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

Estas guías están actualizadas para [v0.4.1](https://github.com/JetSquirrel/DuckLocal/releases/tag/v0.4.1), publicada el 15 de noviembre de 2026. La versión 0.4.0 añadió [flujos de trabajo de agentes](agent-workflows.md): 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).

1. Descarga [`ducklocal-macos-arm64.dmg`](https://dl.ducklocal.app/latest/ducklocal-macos-arm64.dmg).
2. Ábrelo y arrastra **DuckLocal** a **Aplicaciones**.
3. 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**.

1. Descarga [`ducklocal-windows-x86_64.zip`](https://dl.ducklocal.app/latest/ducklocal-windows-x86_64.zip) y extráelo.
2. Ejecuta `ducklocal.exe` desde 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.

```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 Compilar 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.

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

El binario es `./target/release/ducklocal`; úsalo donde esta guía dice
`ducklocal`. Consulta [Desarrollo](development.md) para empaquetar un `.app`.
:::

## 2. Añade el comando `ducklocal` (opcional) {#add-command}

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](cli.md) — añade el comando desde la app:

1. 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.
2. Haz clic en **Instalar comando**. En un Mac, el sistema te pide tu contraseña
   para escribir en `/usr/local/bin`.
3. 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](settings-and-data.md#update-check)). 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](cli.md#install-the-official-skill).

::: details Añadirlo a mano
```bash
sudo mkdir -p /usr/local/bin
sudo ln -sf /Applications/DuckLocal.app/Contents/MacOS/ducklocal /usr/local/bin/ducklocal
```

Para 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 `.parquet` o `.duckdb` en Finder, o
  elige DuckLocal en **Abrir con** para archivos CSV, JSON y Excel. Consulta
  [Abrir desde Finder](data-sources.md#open-from-finder).
- Desde un terminal, indica las rutas:

  ```bash
  ducklocal ./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](data-sources.md) 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](data-sources.md#quick-look) de DuckLocal
muestra las columnas y las primeras filas de archivos Parquet, DuckDB, CSV, TSV y JSON Lines.

::: tip ¿No tienes datos a mano?
El [tutorial de los primeros 10 minutos](tutorial.md) 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):

```sql
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](tutorial.md) — un recorrido guiado con datos de ejemplo
- [Fuentes de datos](data-sources.md) — formatos, carpetas, patrones, bases de datos, Finder y Quick Look
- [Editor SQL](sql-editor.md) — pestañas, atajos, autocompletado, EXPLAIN
- [Resultados y gráficos](results-and-charts.md) — filtrado, exportación, gráficos, el resumen de columnas
- [Paneles (.dash)](dashboards.md) — paneles como archivos de texto y cómo revisarlos con un agente de IA
- [Solución de problemas](troubleshooting.md) — cuando algo no se comporta como esperas
