{"id":21125381,"url":"https://github.com/hmourad2023/querying-mysql-database-llm","last_synced_at":"2025-03-14T11:40:27.387Z","repository":{"id":263427686,"uuid":"890360297","full_name":"HMourad2023/Querying-MySQL-Database-LLM","owner":"HMourad2023","description":"Interactive MySQL Application with AI 🚀  An application to interact with MySQL databases using natural language, powered by an open-source large language model (LLMs).","archived":false,"fork":false,"pushed_at":"2024-11-18T14:08:15.000Z","size":1003,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-21T05:28:14.496Z","etag":null,"topics":["groq","mysql","open-source","open-source-llms","pandas","streamlit"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HMourad2023.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":"2024-11-18T12:45:22.000Z","updated_at":"2024-11-18T14:09:14.000Z","dependencies_parsed_at":"2024-11-18T14:44:15.294Z","dependency_job_id":"868ac384-1a46-4a09-aebb-4e1cea60b5af","html_url":"https://github.com/HMourad2023/Querying-MySQL-Database-LLM","commit_stats":null,"previous_names":["hmourad2023/querying-mysql-database-llm"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HMourad2023%2FQuerying-MySQL-Database-LLM","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HMourad2023%2FQuerying-MySQL-Database-LLM/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HMourad2023%2FQuerying-MySQL-Database-LLM/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HMourad2023%2FQuerying-MySQL-Database-LLM/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HMourad2023","download_url":"https://codeload.github.com/HMourad2023/Querying-MySQL-Database-LLM/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243573162,"owners_count":20312879,"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":["groq","mysql","open-source","open-source-llms","pandas","streamlit"],"created_at":"2024-11-20T04:33:18.819Z","updated_at":"2025-03-14T11:40:27.359Z","avatar_url":"https://github.com/HMourad2023.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"### Interact with MySQL Database Using Open-Source LLMs\n**Description :**  \n\nThe interact_with_MySQL project allows users to interact with a MySQL database using natural language instead of writing complex SQL queries.  \nThe goal is to simplify data access and make interactions more intuitive for users who are not experienced with SQL.\n\nThis project uses Streamlit for the user interface, MySQL-connector for connecting to MySQL, and Groq for API integration and natural language processing (LLMs).\n\n**Features :**  \n\n- Connect to a MySQL database.\n- Execute SQL queries via natural language.\n- Interactive user interface with Streamlit.\n- Integration with the Groq API for natural language model management. \n\n**Data :**\n- Airline Delays :\n    - Airline Delays for December 2019 and 2020\n    - kaggle link : [https://www.kaggle.com/datasets/eugeniyosetrov/airline-delays?select=airline_delay.csv]\n\n**Technologies :**  \n\n- Python 3.10\n- Streamlit\n- MySQL-connector-Python\n- Groq API\n- Conda (for virtual environment management)\n- Git\n- dotenv-python\n- Pandas\n- PyYaml\n- fpdf  \n\n**Prerequisites :**  \n\nBefore starting, ensure you have installed:\n\n- Python 3.10 or higher\n- Conda\n- Git  \n\n**Installation :**  \n\n**Step 1: Clone the Repository :**  \n\nClone the repository to your machine:\n\n```bash\ngit clone https://github.com/HMourad2023/Querying-MySQL-Database-LLM.git\n```\nNavigate to the project directory:\n\n```bash\ncd Querying-MySQL-Database-LLM\n```  \n\n**Step 2: Create a Virtual Environment :**  \n\nCreate a virtual environment with Conda:\n\n```bash\nconda create --name llm python=3.10 -y\n```\nActivate the virtual environment:\n\n```bash\nconda activate llm\n```  \n\n**Step 3: Install Dependencies :**  \n\nUpgrade pip and install the required libraries:\n```bash\npython -m pip install --upgrade pip\n```\n```bash\npip install streamlit mysql-connector-python dotenv-python groq fpfd pyyaml pandas\n```  \n\n**Step 4: Create the Project Structure :**  \n\nCreate the template.py file:\n\n```bash\necho. \u003etemplate.py\n```\nRun the template.py file:\n\n```bash\npython template.py\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhmourad2023%2Fquerying-mysql-database-llm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhmourad2023%2Fquerying-mysql-database-llm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhmourad2023%2Fquerying-mysql-database-llm/lists"}