https://github.com/farbodahm/delephon
Native desktop BigQuery client built with Go, supporting multiple projects, schema explorer, fuzzy search, history, favorite queries, AI assistant
https://github.com/farbodahm/delephon
big-query bigquery gcp golang
Last synced: 2 months ago
JSON representation
Native desktop BigQuery client built with Go, supporting multiple projects, schema explorer, fuzzy search, history, favorite queries, AI assistant
- Host: GitHub
- URL: https://github.com/farbodahm/delephon
- Owner: farbodahm
- Created: 2026-02-09T21:56:51.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-07T00:46:20.000Z (3 months ago)
- Last Synced: 2026-03-07T07:06:37.050Z (3 months ago)
- Topics: big-query, bigquery, gcp, golang
- Language: Go
- Homepage:
- Size: 1.56 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Delephon
A native desktop BigQuery client built with Go and Fyne.


## Where the idea came from
Recently at work, I found myself needing to run ad-hoc queries against BigQuery for data exploration and debugging.
The web UI is fine for quick queries, but it can be slow to load and navigate, especially when switching between projects or tables.
I wanted a lightweight, native app that would let me quickly browse my BigQuery projects, inspect schemas, and run queries without the overhead of a browser.
## Features
- **Smart project explorer** — favorites and recently queried projects show up instantly, all projects load on demand
- **AI Assistant** — describe what you want to query in plain English, and Claude generates BigQuery SQL using your table schemas as context
- **Search projects & tables** — find any table across your starred and recent projects; matching tables surface the project to the top
- **Background caching** — datasets and tables load in parallel behind the scenes, so the second search is instant
- **Query editor** — multi-tab SQL editor with Cmd+Enter / Ctrl+Enter to run
- **Context-aware autocomplete** — type `project.` to see datasets, `project.dataset.` to see tables; data loads automatically in the background when needed
- **SQL autocomplete** — SQL keywords, function names, project/dataset/table names, and column names complete as you type
- **Auto-generated queries** — click a table to get a `SELECT *` with partition filter pre-filled
- **Schema viewer** — inspect table columns, types, and descriptions
- **Query history** — browse and re-run past queries
- **Saved favorites** — bookmark queries you use often
- **Star projects** — pin frequently used projects to the top
## Install
Requires Go 1.24+ and [Application Default Credentials](https://cloud.google.com/docs/authentication/application-default-credentials).
```bash
# Authenticate with GCP
gcloud auth application-default login
# Install and run
go install github.com/farbodahm/delephon@latest
delephon
```
Or clone and run locally:
```bash
git clone https://github.com/farbodahm/delephon.git
cd delephon
go run .
```