DuckGPT Save Abandoned

Ask questions, let GPT do the SQL.

Project README


DuckGPT lets you ask questions about your JSON and CSV files, then answers them by composing SQL queries using ChatGPT and executing them through DuckDB.

Disclaimer: This is a toy project. ChatGPT likes to hallucinate weird queries occasionally, but most of the time, it works surprisingly well! Including the way it's able to automatically respond to errors in queries it writes, and then rewrite them correctly.

Reviews Demo


You can install it using Homebrew:

brew tap cube2222/cube2222
brew install duckgpt

or download one of the static binaries from the releases page. If you're downloading a static binary, make sure to install DuckDB as well.


Provide your OpenAI platform key through the DUCKGPT_TOKEN environment variable. Then, you can run duckgpt in the directory that contains your JSON and/or CSV files.


You've seen one demo at the beginning of the README, now we can take a look at another example, where one of the queries DuckGPT writes is incorrect (at least in the DuckDB SQL dialect). It then rewrites it correctly, without any user interaction.

Logs Demo

Finally, we can turn on debug mode to see the raw messages being exchanged between DuckGPT and ChatGPT.

Logs Debug Demo

Closing Thoughts

Have fun!

Open Source Agenda is not affiliated with "DuckGPT" Project. README Source: cube2222/DuckGPT
Open Issues
Last Commit
5 months ago

Open Source Agenda Badge

Open Source Agenda Rating