프로젝트 소개

dbt Labs의 dbt Charts(패키지 `dbt-charts`, CLI `dct`)는 YAML 보드 정의를 다양한 형식의 인터랙티브 대시보드와 리포트로 컴파일한다. SQL은 어떤 데이터를 볼지 정의하고, YAML은 그것을 어떻게 표현할지 선언한다. 이는 명확하고 감사 가능한 문법으로 바이브 코딩된 대시보드의 혼란을 해결한다. **시작하기:** Python 3.10-3.13이 필요하다. `uv tool install dbt-charts` 또는 `pip install dbt-charts`로 설치한다. 웨어하우스 어댑터는 extras로 추가한다(BigQuery, Snowflake, PostgreSQL 등, DuckDB는 내장). 명령어: `dct init`, `dct validate`, 라이브 미리보기를 위한 `dct serve`. play.dbtcharts.com의 플레이그라운드에서 설치 없이 사용해볼 수 있다. **CLI (`dct`):** 검증, HTML/PDF/PNG/SVG/JSON 렌더링, 쿼리 실행, 보드 검색, 컬럼 영향 추적을 수행하며 오프라인 YAML 레퍼런스를 포함한다. 동사: `validate`, `serve`, `render`, `query`, `search`, `impact`, `docs`, `examples`. **에이전트 스킬과 MCP:** 번들된 스킬(`dct skills intro`)과 VS Code, Cursor, Claude Desktop 등을 위한 로컬 MCP 서버를 제공한다. `dct init mcp`로 연결한다. **VS Code 확장:** 구문 강조, 자동완성, 진단, 라이브 미리보기를 추가한다(CLI 필요). Marketplace와 Open VSX에서 사용 가능하다. **기능:** 로컬 소스(CSV, Parquet, JSON, DuckDB)와 dbt 어댑터를 통한 웨어하우스를 지원한다. 16개 핵심 차트 유형(bar, line, area, scatter, heatmap, pie, donut, KPI, table, maps 등)과 13개 시맨틱 유형(lollipop, bullet, slope, funnel, small multiples)을 제공한다. 커스텀 YAML 확장이 가능한 5개 내장 테마. 실행 가능한 오류 코드로 검증하며, `dct init ci`가 GitHub Actions 워크플로를 추가한다. 마이그레이션이 이전 문법을 자동으로 처리한다. **dbt 통합:** 선택 사항이며, 보드는 독립적으로 존재하거나 dbt 프로젝트에 위치하여 `ref()`를 사용하고 자격 증명을 공유하며 CI 검증을 받을 수 있다. Pydantic, Jinja2, Vega-Lite, FastAPI 기반. Apache License 2.0. 읽기 전용 미러이며 이슈는 환영하지만 PR은 받지 않는다.