---
title: DuckLocal — app desktop DuckDB per SQL sui tuoi file locali
description: Interroga file CSV, Parquet, JSON ed Excel in locale con DuckDB SQL. Nessun server, nessun upload, nessun account, nessuna telemetria.
image: https://ducklocal.app/og-image.jpg?v=2
language: it
---

# DuckLocal

Interroga file CSV, Parquet, JSON ed Excel con DuckDB, proprio dove si trovano sul tuo computer. Nessun server, nessun upload, nessun account.

DuckLocal è un'app desktop gratuita e open source per Mac, Windows e Linux, distribuita con licenza Apache-2.0.

## Il tuo agente nel terminale, i tuoi dati in DuckLocal

Il tuo agente scrive un file `.dash`. Tu lo rivedi in DuckLocal e commenti direttamente sui grafici.

- `ducklocal schema` elenca ogni file, tabella e colonna. `--stats` aggiunge statistiche esatte per colonna.
- `ducklocal query` accetta una sola istruzione SQL e restituisce JSON circoscritto. Se un risultato viene troncato, lo dice.
- `ducklocal open` invia una query o una dashboard alla finestra aperta. `--state` rilegge ciò che stai vedendo.
- `ducklocal check` valida un file `.dash` prima che tu lo veda. Le dashboard si confrontano e si committano come codice.
- `ducklocal comments` permette all'agente di modificare un grafico su cui hai commentato, rispondere e chiudere il thread.
- `ducklocal presence` mostra nella finestra quale grafico l'agente sta leggendo o modificando.

```bash
ducklocal schema ./data/
ducklocal query --sql "SELECT count(*) FROM 'sales.csv'"
```

Collega il tuo agente in tre passaggi:

1. In DuckLocal, apri **Riga di comando e IA…** e clicca **Installa comando** per mettere `ducklocal` nel tuo PATH.
2. Clicca **Aggiungi a Claude Code** per installare la skill ufficiale. Per Codex o Cursor, clicca **Copia il brief** e incollalo.
3. Assegna il compito al tuo agente nel terminale, poi rivedi il risultato e commenta in DuckLocal.

La demo della homepage è calcolata dal campione `sales.csv` di 224 righe del tutorial. Il sito non invia richieste AI e pubblicare un commento non avvia mai un agente da solo.

Leggi [SQL per agenti AI](https://ducklocal.app/it/use-cases/ai-agent-sql/), il [riferimento CLI](https://ducklocal.app/docs/it/cli) e la [guida alle dashboard](https://ducklocal.app/docs/it/dashboards).

## Da un file a una risposta

1. **Trascina un file.** Trascina un CSV, un foglio di calcolo o un'intera cartella. Non c'è nessun passaggio di importazione.
2. **È già una tabella.** `sales.csv` diventa la tabella `sales`, con le sue colonne nella barra laterale. Il file non viene mai copiato o modificato.
3. **Chiedi con SQL.** Premi ⌘↵ per la risposta, poi trasformala in grafico o salvala in CSV o Parquet.

```sql
SELECT channel, round(sum(revenue), 2) AS revenue
FROM sales
GROUP BY channel
ORDER BY revenue DESC;
```

DuckLocal apre CSV, TSV, Parquet, JSON e NDJSON, fogli di calcolo Excel e OpenDocument, database DuckDB, intere cartelle e archiviazione S3, tutto dove si trova.

## Dopo la prima risposta

- Analizza una query per vedere quale passaggio ha richiesto tempo.
- Vedi i valori nulli, i valori distinti e l'intervallo di ogni colonna in un risultato.
- Collega altri database DuckDB o SQLite e gestisci le estensioni dalla barra laterale.
- Su Mac, apri file Parquet e DuckDB dal Finder o visualizzali in anteprima con Quick Look.

## I tuoi dati restano tuoi

- I file vengono letti dove si trovano, mai copiati o caricati.
- Non c'è nessun account, nessuna telemetria e nessun servizio cloud.
- Nulla va online finché non lo attivi tu.
- Open source con licenza Apache-2.0, quindi ogni riga è lì da leggere.

## Le domande più frequenti

### Che cos'è DuckLocal?

Un'app desktop gratuita e open source per interrogare con SQL i file di dati sul tuo computer. DuckDB gira dentro l'app, quindi ogni file che trascini è una tabella che puoi interrogare.

### DuckLocal carica i miei dati?

No. I file vengono letti dove si trovano e non vengono mai copiati, caricati o modificati. Non c'è nessun account e nessuna telemetria.

### Quali formati di file può aprire?

CSV, TSV, Parquet, JSON e NDJSON, fogli di calcolo Excel e OpenDocument, database DuckDB, intere cartelle e file su Amazon S3 o su archiviazione compatibile con S3.

### Su quali sistemi funziona?

macOS 12 o successivo su Apple silicon, Windows 10 a 64 bit o successivo e Linux x86_64 con glibc 2.35 o successivo.

### Quanto possono essere grandi i miei dati?

DuckDB interroga i file direttamente, senza prima caricarli nell'app. La griglia dei risultati mostra fino a 100.000 righe e le esportazioni scrivono il risultato completo.

### Gli agenti AI come Claude Code o Codex possono usarlo?

Sì. Il comando ducklocal esegue SQL dal terminale e stampa JSON. La skill ufficiale insegna all'agente a controllare lo schema prima di interrogare.

## Link

- [Scarica DuckLocal](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [Per iniziare](https://ducklocal.app/docs/it/getting-started)
- [Tutorial di 10 minuti](https://ducklocal.app/docs/it/tutorial)
- [Analisi dei dati locali](https://ducklocal.app/it/use-cases/local-data-analysis/)
- [DuckDB GUI](https://ducklocal.app/it/use-cases/duckdb-gui/)
- [Visualizzatore Parquet](https://ducklocal.app/it/use-cases/parquet-viewer/)
- [Interroga CSV con SQL](https://ducklocal.app/it/use-cases/query-csv-with-sql/)
- [Interrogare Excel con SQL](https://ducklocal.app/it/use-cases/query-excel-with-sql/)
- [Interrogare JSON con SQL](https://ducklocal.app/it/use-cases/query-json-with-sql/)
- [Dashboard SQL](https://ducklocal.app/it/use-cases/sql-dashboards/)
- [DuckLocal vs DBeaver](https://ducklocal.app/it/compare/ducklocal-vs-dbeaver/)
- [Blog](https://ducklocal.app/it/blog/)
- [Documentazione](https://ducklocal.app/docs/it/)
- [Codice sorgente](https://github.com/JetSquirrel/DuckLocal)
- [中文](https://ducklocal.app/zh/)
- [日本語](https://ducklocal.app/ja/)

Source: https://ducklocal.app/it/
