0.4.1의 새로운 기능여러 값 필터, 대시보드 시간대, 타임라인을 추가했습니다

CSV, Parquet, JSON, Excel 파일을 컴퓨터에 있는 그 자리에서 DuckDB로 쿼리합니다. 서버도, 업로드도, 계정도 필요 없습니다.

무료 오픈 소스. Windows와 Linux용도 있습니다.

공유 화면의 차트를 가리키는 사람 옆에서 DuckLocal 오리와 에이전트 로봇이 함께 작업하는 모습
  • 앱 안의 DuckDB
  • 에이전트를 위한 헤드리스 JSON CLI
  • Mac, Windows, Linux
  • 오픈 소스, Apache-2.0
❯sales.csv로 매출 대시보드를 만들어 줘.
⏺Bash(ducklocal open sales.dash)

셸을 실행할 수 있는 에이전트라면 무엇이든Gemini CLI, Qwen Code, DeepSeek 등

문서
스키마기록
  • 로컬 파일1
  • sales224
  • dateDATE
  • channelVARCHAR
  • regionVARCHAR
  • ordersBIGINT
  • revenueDOUBLE
sales
sales.dash
매출
902,673.36
주문
12,088
지역
4

채널별 매출

채널별 매출 · 클릭해서 필터

300k150k0

일별 매출

날짜별 매출

70.3k0
09-0109-0709-14

숫자로 보기

#daterevenue
12026-09-0162,598.48
22026-09-0257,985.04
32026-09-0363,822.32
42026-09-0466,597.12
52026-09-0570,272.00
62026-09-0669,695.60
72026-09-0764,956.32
82026-09-0869,076.72
92026-09-0968,762.00
102026-09-1057,039.12
112026-09-1165,157.92
122026-09-1263,551.60
132026-09-1355,106.72
142026-09-1468,052.40
연결됨DuckLocal

막대를 클릭해 필터링하거나, 말풍선을 눌러 주석을 남기세요.

에이전트는 터미널에서.
데이터는 DuckLocal에서.

에이전트가 .dash 파일을 작성합니다. DuckLocal에서 검토하고 차트 위에 바로 주석을 남기세요.

CLI와 에이전트 스킬 ↗대시보드 가이드 ↗
  • ducklocal schema

    쿼리 전에 먼저 보기

    모든 파일, 테이블, 열을 나열합니다. --stats를 붙이면 열별 정확한 통계도 나옵니다.

  • ducklocal query

    추측이 아닌 JSON

    SQL 문 하나를 넣으면 범위가 제한된 JSON이 나옵니다. 결과가 잘린 경우에도 그 사실이 표시됩니다.

  • ducklocal open

    눈앞의 창으로

    쿼리나 대시보드를 열려 있는 창으로 보냅니다. --state로 지금 보이는 내용을 다시 읽어옵니다.

  • ducklocal check

    대시보드는 텍스트 파일

    .dash 파일은 코드처럼 diff하고 커밋할 수 있고, 보기 전에 검사를 거칩니다.

  • ducklocal comments

    차트 위에서 검토

    차트에 주석을 남기면 에이전트가 수정하고, 답글을 달고, 스레드를 해결합니다.

  • ducklocal presence

    에이전트가 하는 일 보기

    에이전트가 어떤 차트를 읽거나 편집하는지 창에 표시됩니다.

세 단계로 에이전트 연결

  1. DuckLocal에서 명령줄 & AI…를 열고 명령 설치를 클릭하면 ducklocal이 PATH에 추가됩니다.
  2. Claude Code에 추가를 클릭하면 공식 스킬이 설치됩니다. Codex나 Cursor에서는 브리프 복사를 클릭해 붙여 넣으세요.
  3. 터미널에서 에이전트에 작업을 맡기고, 결과를 DuckLocal에서 검토하며 주석을 남기세요.
# 명령줄 & AI… → 명령 설치 → Claude Code에 추가
$ claude
❯ sales.csv로 매출 대시보드를 만들고 DuckLocal에서 열어 줘.
❯ sales.dash의 주석을 처리해 줘.

파일에서 답까지

  1. 파일을 넣습니다

    CSV, 스프레드시트, 폴더 전체를 끌어다 놓습니다. 가져오기 단계가 없습니다.

  2. 이미 테이블입니다

    sales.csv는 테이블 sales가 되고, 열은 사이드바에 표시됩니다. 파일은 복사되거나 변경되지 않습니다.

  3. SQL로 질문합니다

    ⌘↵를 누르면 답이 나옵니다. 그다음 차트로 만들거나 CSV, Parquet로 저장하세요.

이미 가진 데이터를 그대로 엽니다

모든 파일을 있는 자리에서 엽니다.

  • .csv쉼표로 구분
  • .tsv탭으로 구분
  • .parquet컬럼 기반, 빠른 읽기
  • .json .ndjson문서, 또는 한 줄에 레코드 하나
  • .xlsx .xls .ods시트마다 테이블 하나
  • .duckdb데이터베이스로 열거나, 옆에 연결
  • s3://버킷과 S3 호환 스토리지
  • folder/안에 있는 모든 데이터 파일, 또는 *.csv 같은 패턴

첫 번째 답 이후

쿼리가 왜 느린지, 열에 무엇이 들어 있는지, 테이블이 어디에 있는지 확인합니다.

SQL 편집기 · 결과와 차트 · 데이터 소스

  • 쿼리를 프로파일링해 어느 단계에서 시간이 걸렸는지 확인합니다.
  • 결과의 모든 열에서 NULL, 고유값, 범위를 확인합니다.
  • DuckDB나 SQLite 데이터베이스를 더 연결하고, 사이드바에서 확장 기능을 관리합니다.
  • Mac에서는 Finder에서 Parquet, DuckDB 파일을 열거나 Quick Look으로 미리 볼 수 있습니다.

데이터는 당신의 것입니다

  • 파일은 있는 자리에서 읽히며, 복사되거나 업로드되지 않습니다.
  • 계정도, 텔레메트리도, 클라우드 서비스도 없습니다.
  • 직접 켜기 전에는 아무것도 외부로 나가지 않습니다.
  • Apache-2.0 오픈 소스이므로 모든 코드를 직접 읽을 수 있습니다.

자주 묻는 질문

DuckLocal이란 무엇인가요?

컴퓨터에 있는 데이터 파일을 SQL로 쿼리하는 무료 오픈 소스 데스크톱 앱입니다. 앱 안에서 DuckDB가 실행되므로, 넣은 파일이 곧 쿼리할 수 있는 테이블이 됩니다.

DuckLocal이 제 데이터를 업로드하나요?

아니요. 파일은 있는 자리에서 읽히며 복사되거나, 업로드되거나, 변경되지 않습니다. 계정도 텔레메트리도 없습니다.

어떤 파일 형식을 열 수 있나요?

CSV, TSV, Parquet, JSON, NDJSON, Excel과 OpenDocument 스프레드시트, DuckDB 데이터베이스, 폴더 전체, 그리고 Amazon S3 또는 S3 호환 스토리지의 파일을 엽니다.

어떤 시스템에서 실행되나요?

Apple silicon의 macOS 12 이상, 64비트 Windows 10 이상, glibc 2.35 이상의 x86_64 Linux입니다.

데이터는 얼마나 커도 되나요?

DuckDB는 파일을 앱에 먼저 불러오지 않고 직접 쿼리합니다. 결과 그리드에는 최대 100,000행이 표시되고, 내보내기에서는 결과 전체가 기록됩니다.

Claude Code나 Codex 같은 AI 에이전트도 쓸 수 있나요?

네. ducklocal 명령은 터미널에서 SQL을 실행하고 JSON을 출력합니다. 공식 스킬은 에이전트가 쿼리 전에 스키마를 확인하도록 가르칩니다.

내 파일로 직접 써 보세요

DuckLocal을 내려받아 파일을 넣고 쿼리를 실행해 보세요.