{"id":16192811,"url":"https://github.com/cube2222/duckgpt","last_synced_at":"2025-03-16T10:32:29.496Z","repository":{"id":155913178,"uuid":"619163124","full_name":"cube2222/DuckGPT","owner":"cube2222","description":"Ask questions, let GPT do the SQL.","archived":false,"fork":false,"pushed_at":"2023-03-26T14:58:05.000Z","size":8472,"stargazers_count":132,"open_issues_count":0,"forks_count":10,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-11T00:34:21.882Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cube2222.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-26T13:09:19.000Z","updated_at":"2024-08-12T22:02:22.000Z","dependencies_parsed_at":"2024-06-21T16:36:01.929Z","dependency_job_id":"5f116a5b-5417-4dc6-b2d7-8cf16856b458","html_url":"https://github.com/cube2222/DuckGPT","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cube2222%2FDuckGPT","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cube2222%2FDuckGPT/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cube2222%2FDuckGPT/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cube2222%2FDuckGPT/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cube2222","download_url":"https://codeload.github.com/cube2222/DuckGPT/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243814907,"owners_count":20352037,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-10T08:12:35.933Z","updated_at":"2025-03-16T10:32:28.770Z","avatar_url":"https://github.com/cube2222.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DuckGPT\n\nDuckGPT lets you ask questions about your JSON and CSV files, then answers them by composing SQL queries using [ChatGPT](https://platform.openai.com/docs/models/gpt-3-5) and executing them through [DuckDB](https://duckdb.org).\n\nDisclaimer: 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.\n\n![Reviews Demo](images/reviews.gif)\n\n## Installation\n\nYou can install it using Homebrew:\n```bash\nbrew tap cube2222/cube2222\nbrew install duckgpt\n```\nor download one of the static binaries from the releases page. If you're downloading a static binary, make sure to install DuckDB as well.\n\n## Usage\nProvide 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.\n\n## Demo\n\nYou'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.\n\n![Logs Demo](images/logs.gif)\n\nFinally, we can turn on debug mode to see the raw messages being exchanged between DuckGPT and ChatGPT.\n\n![Logs Debug Demo](images/logs-debug.gif)\n\n## Closing Thoughts\n\nHave fun!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcube2222%2Fduckgpt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcube2222%2Fduckgpt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcube2222%2Fduckgpt/lists"}