---
title: DuckLocal — настольное приложение DuckDB для SQL по локальным файлам
description: Запрашивайте CSV-, Parquet-, JSON- и Excel-файлы локально через DuckDB SQL. Без сервера, загрузки, аккаунта и телеметрии.
image: https://ducklocal.app/og-image.jpg?v=2
language: ru
---

# DuckLocal

Запрашивайте CSV-, Parquet-, JSON- и Excel-файлы через DuckDB прямо там, где они лежат на вашем компьютере. Без сервера, загрузки и аккаунта.

DuckLocal — бесплатное настольное приложение с открытым исходным кодом для Mac, Windows и Linux под лицензией Apache-2.0.

## Ваш агент в терминале, ваши данные в DuckLocal

Ваш агент пишет файл `.dash`. Вы проверяете его в DuckLocal и комментируете прямо на графиках.

- `ducklocal schema` перечисляет каждый файл, таблицу и столбец. `--stats` добавляет точную статистику по каждому столбцу.
- `ducklocal query` принимает одну SQL-инструкцию и возвращает ограниченный JSON. Обрезанный результат сообщает об этом.
- `ducklocal open` отправляет запрос или дашборд в открытое окно. `--state` возвращает то, что вы видите.
- `ducklocal check` проверяет файл `.dash` до того, как вы его увидите. Дашборды сравниваются и коммитятся как код.
- `ducklocal comments` позволяет агенту править график, который вы прокомментировали, отвечать и закрывать обсуждение.
- `ducklocal presence` показывает в окне, какой график агент читает или редактирует.

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

Подключите агента за три шага:

1. В DuckLocal откройте **Command line & AI…** и нажмите **Install command**, чтобы добавить `ducklocal` в PATH.
2. Нажмите **Add to Claude Code**, чтобы установить официальный навык. Для Codex или Cursor нажмите **Copy brief** и вставьте бриф.
3. Дайте задачу агенту в терминале, затем проверьте результат и оставьте комментарий в DuckLocal.

Демо на главной странице рассчитано по образцу `sales.csv` из учебника на 224 строки. Сайт не отправляет запросов к ИИ, а публикация комментария сама по себе не запускает агента.

Читайте [SQL для ИИ-агентов](https://ducklocal.app/ru/use-cases/ai-agent-sql/), [справочник по CLI](https://ducklocal.app/docs/ru/cli) и [руководство по дашбордам](https://ducklocal.app/docs/ru/dashboards).

## От файла к ответу

1. **Перетащите файл.** Перетащите CSV, таблицу или целую папку. Шага импорта нет.
2. **Это уже таблица.** `sales.csv` становится таблицей `sales`, а её столбцы появляются в боковой панели. Файл никогда не копируется и не изменяется.
3. **Спросите через SQL.** Нажмите ⌘↵, чтобы получить ответ, затем постройте график или сохраните его в CSV или Parquet.

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

DuckLocal открывает CSV, TSV, Parquet, JSON и NDJSON, таблицы Excel и OpenDocument, базы данных DuckDB, целые папки и хранилища S3 — всё там, где лежит.

## После первого ответа

- Профилируйте запрос, чтобы увидеть, какой шаг занял время.
- Смотрите NULL-значения, уникальные значения и диапазон каждого столбца в результате.
- Подключайте другие базы DuckDB или SQLite и управляйте расширениями из боковой панели.
- В Mac открывайте файлы Parquet и DuckDB из Finder или просматривайте их через Quick Look.

## Ваши данные остаются вашими

- Файлы читаются там, где лежат, и никогда не копируются и не загружаются.
- Нет ни аккаунта, ни телеметрии, ни облачного сервиса.
- Ничего не уходит в сеть, пока вы сами это не включите.
- Открытый исходный код под Apache-2.0 — можно прочитать каждую строку.

## Вопросы, которые задают

### Что такое DuckLocal?

Бесплатное настольное приложение с открытым исходным кодом для запросов к файлам данных на вашем компьютере через SQL. DuckDB работает внутри приложения, поэтому каждый добавленный файл — это таблица, к которой можно делать запросы.

### Загружает ли DuckLocal мои данные?

Нет. Файлы читаются там, где лежат, и никогда не копируются, не загружаются и не изменяются. Аккаунта и телеметрии нет.

### Какие форматы файлов он открывает?

CSV, TSV, Parquet, JSON и NDJSON, таблицы Excel и OpenDocument, базы данных DuckDB, целые папки, а также файлы в Amazon S3 или S3-совместимых хранилищах.

### На каких системах он работает?

macOS 12 или новее на Apple silicon, 64-битная Windows 10 или новее и x86_64 Linux с glibc 2.35 или новее.

### Насколько большими могут быть мои данные?

DuckDB запрашивает файлы напрямую, не загружая их сначала в приложение. Сетка результатов показывает до 100 000 строк, а экспорт записывает результат целиком.

### Могут ли им пользоваться ИИ-агенты вроде Claude Code или Codex?

Да. Команда ducklocal выполняет SQL из терминала и выводит JSON. Официальный навык учит агента проверять схему перед запросом.

## Ссылки

- [Скачать DuckLocal](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [Начало работы](https://ducklocal.app/docs/ru/getting-started)
- [Учебник на 10 минут](https://ducklocal.app/docs/ru/tutorial)
- [Анализ локальных данных](https://ducklocal.app/ru/use-cases/local-data-analysis/)
- [DuckDB GUI](https://ducklocal.app/ru/use-cases/duckdb-gui/)
- [Просмотрщик Parquet](https://ducklocal.app/ru/use-cases/parquet-viewer/)
- [SQL-запросы к CSV](https://ducklocal.app/ru/use-cases/query-csv-with-sql/)
- [Запросы к Excel через SQL](https://ducklocal.app/ru/use-cases/query-excel-with-sql/)
- [Запросы к JSON через SQL](https://ducklocal.app/ru/use-cases/query-json-with-sql/)
- [SQL-дашборды](https://ducklocal.app/ru/use-cases/sql-dashboards/)
- [DuckLocal или DBeaver](https://ducklocal.app/ru/compare/ducklocal-vs-dbeaver/)
- [Блог](https://ducklocal.app/ru/blog/)
- [Документация](https://ducklocal.app/docs/ru/)
- [Исходный код](https://github.com/JetSquirrel/DuckLocal)
- [中文](https://ducklocal.app/zh/)
- [日本語](https://ducklocal.app/ja/)

Source: https://ducklocal.app/ru/
