{"id":19218411,"url":"https://github.com/abhi5h3k/llquery","last_synced_at":"2025-04-10T19:21:34.685Z","repository":{"id":237733916,"uuid":"795094382","full_name":"Abhi5h3k/LLQuery","owner":"Abhi5h3k","description":"LLQuery : Your Conversational SQL Bridge Harness the power of natural language to effortlessly craft SQL queries with LLQuery. ","archived":false,"fork":false,"pushed_at":"2024-11-04T15:52:17.000Z","size":749,"stargazers_count":5,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-24T17:01:42.619Z","etag":null,"topics":["chainlit","chatgpt","docker","duckdb","gpt","gpt-database","gpt-sql","langchain","llm","local-llm","ollama","simple-gpt","sql"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Abhi5h3k.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2024-05-02T15:15:19.000Z","updated_at":"2024-11-23T10:32:38.000Z","dependencies_parsed_at":"2024-05-03T03:55:05.800Z","dependency_job_id":"9977e839-9483-44bf-921d-0a74c1b96bd7","html_url":"https://github.com/Abhi5h3k/LLQuery","commit_stats":null,"previous_names":["abhi5h3k/llquery"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abhi5h3k%2FLLQuery","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abhi5h3k%2FLLQuery/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abhi5h3k%2FLLQuery/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abhi5h3k%2FLLQuery/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Abhi5h3k","download_url":"https://codeload.github.com/Abhi5h3k/LLQuery/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248281382,"owners_count":21077423,"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":["chainlit","chatgpt","docker","duckdb","gpt","gpt-database","gpt-sql","langchain","llm","local-llm","ollama","simple-gpt","sql"],"created_at":"2024-11-09T14:26:35.136Z","updated_at":"2025-04-10T19:21:34.645Z","avatar_url":"https://github.com/Abhi5h3k.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LLQuery 🚀🤖  \u003cimg src=\"https://zeevector.com/wp-content/uploads/New-Transparent-Logo-label@zeevector.png\" width=\"50px\"\u003e\n\n[![Abhishek LinkedIn](https://img.shields.io/badge/Abhishek-LinkedIn-blue.svg?style=for-the-badge)](https://www.linkedin.com/in/abhi5h3k/) [![Abhishek StackOverflow](https://img.shields.io/badge/Abhishek-StackOverflow-orange.svg?style=for-the-badge)](https://stackoverflow.com/users/6870223/abhi?tab=profile)\n\n\u003cimg src=\"LLQueryDark.png\" width=\"250\"\u003e \n\n## 🔐 LLQuery : Your Conversational SQL Bridge\n\n![LLQuery](LLQuery.gif)\n\n## Project Overview\n\nHarness the power of natural language to effortlessly craft SQL queries with LLQuery. This innovative chatbot, built for Docker, empowers users of all technical backgrounds to interact with their databases intuitively.\n\nLeveraging the cutting-edge capabilities of large language models, LLQuery bridges the gap between human thought and database syntax. Simply ask your question in plain language, and LLQuery will translate it into an accurate SQL query, ready for execution.\n\nFor ease, we have taken a sample **SQLite db**. You can use similar logic for any other database schema. This is a proof of concept on how LLM can be leveraged with DB.\n\n![Chinook ERD](https://github.com/Abhi5h3k/LLQuery/assets/37928721/791c16df-a705-4b05-a75a-0c7b3dc963ed)\n\n## Use Cases:\n\n- **Streamlined Data Analysis**: Craft complex SQL queries with ease, empowering data-driven insights.\n- **Simplified Database Interaction**: Non-technical users can now access and manipulate databases effectively.\n- **Enhanced Productivity**: Save valuable time by eliminating the need to manually write intricate SQL code.\n- **Democratized Data Access**: Empower everyone to unlock the potential of their databases.\n- **Educational Tool**: Introduce SQL concepts in a natural and engaging way, fostering data literacy.\n- **Customizable Integration**: Seamlessly integrate LLQuery into your existing workflows for optimal efficiency.\n\n### Prerequisites\n\n- [Python 3.11.0](https://www.python.org/downloads/)\n- pip 24.0\n- Docker version 26.0.0\n- I'm on windows so my Docker Compose version is v2.26.1-desktop.1\n\n## Setup Instructions\n\n\u003cimg src=\"LLQueryWhite.png\" width=\"250\"\u003e\n\n1. Clone the project repository using Git.\n2. Run `docker compose up --build -d`\n3. Check container are up `docker ps`\n\n   ![docker ps](docker_ps.png)\n\n4. Install required model for SQL LLM : `docker exec llquery-ollama-1 ollama run duckdb-nsql`\n\n   Read about duckdb-nsql https://ollama.com/library/duckdb-nsql\n\n   \u003cimg src=\"https://github.com/ollama/ollama/assets/3325447/b9217c78-0803-45fe-90cf-00bd76705a37\" width=\"250\"\u003e\n\n5. If everything goes right, you will be able to access the app at `http://localhost:8000/`.\n\n#### Follow these instructions meticulously to ensure seamless functionality and accurate outcomes.\n\n## Helpful Commands\n\n1. Run Chat app without docker\n\n   - python -m pip install --upgrade pip\n   - pip install -r requirements.txt\n   - chainlit run app.py -w\n\n2. Test Ollama model is up\n\n   - curl http://localhost:11434/api/tags\n   - curl ollama:11434/api/tags\n\n## Note:\nInference speed will depend upon CPU cores and avaialble RAM. It's recomended to have multi core CPU (Laptop / PC) with atleast 16GB RAM. You can deploy it on Server for better performance.\n\nTested on : \n+ Windows 10\n+ i7-10510U CPU @ 1.80GHz \n+ cores : 4\n+ RAM : 16GB\n\n## Welcome screen\n\nTo modify the welcome screen, edit the `chainlit.md` file at the root of your project. If you do not want a welcome screen, just leave this file empty.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabhi5h3k%2Fllquery","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabhi5h3k%2Fllquery","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabhi5h3k%2Fllquery/lists"}