Demo: https://github.com/kvatch-hub/kvatch-cli
Download: https://github.com/kvatch-hub/kvatch-cli/releases/tag/v1.0.0…
## Why I Built This
As a data engineer, I got tired of the “export-download-import-wrangle” dance every time I needed to join data from different sources. The usual workflow:
1. Export from Postgres
2. Download CSV from somewhere
3. Grab data from Google Sheets
4. Spend 3 hours in Python/Excel joining everything
5. Fix encoding issues
6. Realize you exported wrong columns
7. Repeat
It’s 2026. This shouldn’t be so hard.
## What It Does
Define data sources in YAML and query across them with standard SQL:
“`yaml
connectors:
– name: prod_db
type: postgres
connection: postgres://localhost/production
- name: sales_data
type: csv
connection: ./sales.csv
datasets:
– name: analysis
query: |
SELECT u.name, s.revenue
FROM prod_db.users u
LEFT JOIN sales_data s ON u.id = s.user_id
“`
Run: `kvatch query –plan analysis.yaml`
Kvatch executes the query across sources and returns results — no exports, no intermediate files.
## Technical Approach
– Written in Go (single binary, ~12MB)
– Uses SQL federation (not ETL — queries sources directly)
– Local SQLite for caching/intermediate results
– Pluggable connector architecture
– Supports Postgres, MySQL, SQLite, CSV, JSON, Google Sheets, Git repos, REST APIs
Everything runs locally. Your data never leaves your machine.
## Current Status
Core engine is production-ready (tested with real datasets), but calling it “beta” because I want feedback before v1.0. Some UX polish still needed (diagnostics commands, better logging, etc.).
Supported platforms: macOS (Intel + Apple Silicon), Linux (x86_64 + ARM64), Windows.
## What’s Next
Building a paid “remote mode” for teams: shared plans, scheduled queries, web UI, access control. Local mode will stay free forever.
## Try It
“`bash
brew tap kvatch-hub/tap
brew install kvatch
# Or download: https://github.com/kvatch-hub/kvatch-cli/releases
kvatch init
kvatch query –plan examples/quickstart/plan.yaml
“`
Examples: https://github.com/kvatch-hub/kvatch-cli/tree/main/examples
Happy to answer questions! Feedback very welcome.