Airbyte Motherduck Hackathon

Welcome to Natural Language MotherDuck, where natural language meets SQL wizardry for data exploration! This innovative web app, built with Next.js, combines the AI-powered might of MotherDuck with Airbyte's robust data integration. Dive into data querying without writing a single line of SQL—experience seamless visualization, query explanations, and more.

🚀 Built for the Airbyte MotherDuck Hackathon, this project empowers data enthusiasts, analysts, and developers with a simple question: “What if querying data felt as natural as chatting with a friend?”

Why Choose Natural Language MotherDuck?

No-SQL Needed: Transform plain English into complex SQL queries.
Dynamic Data Visualization: Automatically generate charts and tables from queries.
AI-Powered SQL Explanations: Get a section-wise breakdown of queries for easy learning.
Seamless Data Integration: Use Airbyte’s vast connector library to load data into MotherDuck for fast, real-time analysis.

Let’s walk through how you can quack your way to analytics greatness!

🐣 Step 1: Load Data with Airbyte

First things first—import your data from a variety of sources using Airbyte’s comprehensive connectors.

How to Connect Data

Launch Airbyte and select a connector—whether a database, API, or CSV file.
Configure the connection to your MotherDuck instance (local or cloud).
Run the pipeline to load the data into MotherDuck.

Now, your data is ready to be explored!

🐥 Step 2: Query Data with Natural Language

With Natural Language MotherDuck, type plain-English questions and get SQL queries automatically generated.

Example Query:

list contributors with there commits count

MotherDuck AI transforms this into:

SELECT login, total AS commits_count FROM contributor_activity;

Instantly view the results as a table or switch to a dynamic chart.

🦆 Feature Spotlight

1. Dynamic Data Visualization

Results are presented as interactive charts or tables. Choose from bar graphs, pie charts, and line graphs to best represent your data.

2. Explain Query

Understanding SQL is now easier than ever! Click “Explain Query” to break down complex SQL into digestible, plain-English explanations for each clause.

SELECT: Columns displayed.
FROM: Data source table.
WHERE: Conditions filtering results.
ORDER BY: Sorting criteria.

🏆 Key Features Summary

Feature	Benefit
Natural Language to SQL	Query data without coding—just type plain English.
Data Visualization	Auto-generated, dynamic charts for easy insights.
Explain SQL	Break down and learn complex SQL queries, clause by clause.
Airbyte Integration	Import data from hundreds of sources into MotherDuck for real-time analytics.

🏗️ Getting Started with Natural Language MotherDuck

Clone the repository and install dependencies:

 https://github.com/parthiv11/airbyte-motherduck-hackathon
 cd airbyte-motherduck-hackathon
 pnpm install

Configure your environment variables:
```
 cp .env.example .env
```

Add your MotherDuck token:

 motherduck_token=your_motherduck_token_here

Start the development server:
```
 pnpm run dev
```

Visit http://localhost:3000 and experience SQL-free querying and analytics magic.

🌐 Explore More

With Natural Language MotherDuck, turn every question into an actionable insight—quack smarter, analyze faster! 🦆

Visit the demo: airbyte-motherduck-hackathon.vercel.app

🦆 Quack Your Data: Natural Language MotherDuck 🛠️

Table of contents