---
title: DuckLocal — aplicativo desktop DuckDB para SQL nos seus arquivos locais
description: Consulte arquivos CSV, Parquet, JSON e Excel localmente com SQL do DuckDB. Sem servidor, upload, conta ou telemetria.
image: https://ducklocal.app/og-image.jpg?v=2
language: pt
---

# DuckLocal

Consulte arquivos CSV, Parquet, JSON e Excel com DuckDB, exatamente onde eles estão no seu computador. Sem servidor, upload ou conta.

O DuckLocal é um aplicativo desktop gratuito e de código aberto para Mac, Windows e Linux, licenciado sob Apache-2.0.

## Seu agente no terminal, seus dados no DuckLocal

Seu agente escreve um arquivo `.dash`. Você o revisa no DuckLocal e comenta direto nos gráficos.

- `ducklocal schema` lista cada arquivo, tabela e coluna. `--stats` acrescenta estatísticas exatas por coluna.
- `ducklocal query` recebe uma instrução SQL e devolve JSON limitado. Se o resultado for cortado, ele avisa.
- `ducklocal open` envia uma consulta ou um dashboard para a janela aberta. `--state` lê de volta o que você está vendo.
- `ducklocal check` valida um arquivo `.dash` antes de você vê-lo. Dashboards fazem diff e commit como código.
- `ducklocal comments` permite que o agente edite um gráfico que você comentou, responda e resolva a conversa.
- `ducklocal presence` mostra na janela qual gráfico o agente está lendo ou editando.

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

Conecte seu agente em três passos:

1. No DuckLocal, abra **Linha de comando e IA…** e clique em **Instalar comando** para colocar o `ducklocal` no seu PATH.
2. Clique em **Adicionar ao Claude Code** para instalar a skill oficial. Para Codex ou Cursor, clique em **Copiar resumo** e cole.
3. Entregue a tarefa ao seu agente no terminal, depois revise o resultado e comente no DuckLocal.

A demo na página inicial é calculada a partir da amostra `sales.csv` de 224 linhas do tutorial. O site não envia nenhuma requisição de IA, e publicar um comentário nunca inicia um agente por si só.

Leia [SQL para agentes de IA](https://ducklocal.app/pt/use-cases/ai-agent-sql/), a [referência da CLI](https://ducklocal.app/docs/pt/cli) e o [guia de dashboards](https://ducklocal.app/docs/pt/dashboards).

## De um arquivo a uma resposta

1. **Arraste um arquivo.** Arraste um CSV, uma planilha ou uma pasta inteira. Não há etapa de importação.
2. **Já é uma tabela.** `sales.csv` vira a tabela `sales`, com suas colunas na barra lateral. O arquivo nunca é copiado nem alterado.
3. **Pergunte com SQL.** Pressione ⌘↵ para obter a resposta, depois faça um gráfico ou salve como CSV ou Parquet.

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

O DuckLocal abre CSV, TSV, Parquet, JSON e NDJSON, planilhas do Excel e do OpenDocument, bancos de dados DuckDB, pastas inteiras e armazenamento S3, tudo onde está.

## Depois da primeira resposta

- Faça o profile de uma consulta para ver qual etapa levou o tempo.
- Veja os nulos, os valores distintos e o intervalo de cada coluna em um resultado.
- Anexe mais bancos de dados DuckDB ou SQLite e gerencie extensões pela barra lateral.
- No Mac, abra arquivos Parquet e DuckDB pelo Finder, ou visualize-os com o Quick Look.

## Seus dados continuam seus

- Os arquivos são lidos onde estão, nunca copiados ou enviados.
- Não há conta, telemetria nem serviço de nuvem.
- Nada vai para a internet até você ativar.
- Código aberto sob Apache-2.0, então cada linha está lá para ser lida.

## Perguntas frequentes

### O que é o DuckLocal?

Um aplicativo desktop gratuito e de código aberto para consultar com SQL os arquivos de dados no seu computador. O DuckDB roda dentro do aplicativo, então cada arquivo que você arrasta é uma tabela que você pode consultar.

### O DuckLocal envia meus dados?

Não. Os arquivos são lidos onde estão e nunca são copiados, enviados ou alterados. Não há conta nem telemetria.

### Quais formatos de arquivo ele abre?

CSV, TSV, Parquet, JSON e NDJSON, planilhas do Excel e do OpenDocument, bancos de dados DuckDB, pastas inteiras e arquivos no Amazon S3 ou em armazenamento compatível com S3.

### Em quais sistemas ele roda?

macOS 12 ou posterior em Apple silicon, Windows 10 de 64 bits ou posterior, e Linux x86_64 com glibc 2.35 ou mais recente.

### Qual pode ser o tamanho dos meus dados?

O DuckDB consulta os arquivos diretamente, sem carregá-los primeiro no aplicativo. A grade de resultados mostra até 100.000 linhas, e as exportações gravam o resultado completo.

### Agentes de IA como Claude Code ou Codex podem usá-lo?

Sim. O comando ducklocal executa SQL a partir do terminal e imprime JSON. A skill oficial ensina o agente a verificar o esquema antes de consultar.

## Links

- [Baixar o DuckLocal](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [Primeiros passos](https://ducklocal.app/docs/pt/getting-started)
- [Tutorial de 10 minutos](https://ducklocal.app/docs/pt/tutorial)
- [Análise de dados locais](https://ducklocal.app/pt/use-cases/local-data-analysis/)
- [DuckDB GUI](https://ducklocal.app/pt/use-cases/duckdb-gui/)
- [Visualizador de Parquet](https://ducklocal.app/pt/use-cases/parquet-viewer/)
- [Consultar CSV com SQL](https://ducklocal.app/pt/use-cases/query-csv-with-sql/)
- [Consultar Excel com SQL](https://ducklocal.app/pt/use-cases/query-excel-with-sql/)
- [Consultar JSON com SQL](https://ducklocal.app/pt/use-cases/query-json-with-sql/)
- [Painéis SQL](https://ducklocal.app/pt/use-cases/sql-dashboards/)
- [DuckLocal vs DBeaver](https://ducklocal.app/pt/compare/ducklocal-vs-dbeaver/)
- [Blog](https://ducklocal.app/pt/blog/)
- [Documentação](https://ducklocal.app/docs/pt/)
- [Código-fonte](https://github.com/JetSquirrel/DuckLocal)
- [中文](https://ducklocal.app/zh/)
- [日本語](https://ducklocal.app/ja/)

Source: https://ducklocal.app/pt/
