{"id":13441406,"url":"https://github.com/whoiskatrin/sql-translator","last_synced_at":"2025-05-14T14:07:33.238Z","repository":{"id":140721290,"uuid":"612750561","full_name":"whoiskatrin/sql-translator","owner":"whoiskatrin","description":"SQL Translator is a tool for converting natural language queries into SQL code using artificial intelligence. This project is 100% free and open source.","archived":false,"fork":false,"pushed_at":"2024-07-25T04:28:43.000Z","size":4284,"stargazers_count":4262,"open_issues_count":6,"forks_count":365,"subscribers_count":32,"default_branch":"main","last_synced_at":"2025-04-10T03:48:08.839Z","etag":null,"topics":["data-analysis","data-engineering","dataquery","datascience","dataset","openai","postgresql","query","sql"],"latest_commit_sha":null,"homepage":"https://www.sqltranslate.app/","language":"TypeScript","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/whoiskatrin.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-11T21:32:56.000Z","updated_at":"2025-04-08T07:56:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"e8181b3a-298a-4219-a872-f2844a283f76","html_url":"https://github.com/whoiskatrin/sql-translator","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whoiskatrin%2Fsql-translator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whoiskatrin%2Fsql-translator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whoiskatrin%2Fsql-translator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whoiskatrin%2Fsql-translator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/whoiskatrin","download_url":"https://codeload.github.com/whoiskatrin/sql-translator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254159194,"owners_count":22024558,"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":["data-analysis","data-engineering","dataquery","datascience","dataset","openai","postgresql","query","sql"],"created_at":"2024-07-31T03:01:33.573Z","updated_at":"2025-05-14T14:07:33.197Z","avatar_url":"https://github.com/whoiskatrin.png","language":"TypeScript","readme":"\u003ch1 align=\"center\"\u003eSQL Translator\u003cbr\u003e(SQL to Natural Language and Natural Language to SQL)\u003c/h1\u003e\n\nWelcome to the SQL and Natural Language Translator! This tool is designed to make it easy for anyone to translate SQL (Structured Query Language) commands into natural language and vice versa. SQL is a programming language used to manage and manipulate data in relational databases, and while it's a powerful tool, it can also be quite complex and difficult to understand. On the other hand, natural language is the language that we speak and write in everyday life, and it's often the preferred way to communicate for people who are not familiar with technical jargon.\n\nWith the SQL and Natural Language Translator, you don't need to be a SQL expert to understand what's going on in your database, or to write SQL queries. You can simply type in your query in natural language and get the corresponding SQL code, or type in your SQL code and get a human-readable translation.This project is 100% free and open source.\n\n\u003cbr\u003e\n\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"https://github.com/whoiskatrin/sql-translator/blob/main/UI.png\" width=\"600\" /\u003e\n\u003c/div\u003e\n\n## 🌟 Features\n\n- Dark mode\n- Lowercase/uppercase toggle\n- Copy to clipboard\n- SQL syntax highlighting\n- Schema awareness (beta)\n- Query history\n\n\n## 📖 How to use:\n\nUsing the SQL to Natural Language Translator is easy. Simply navigate to the tool's website and choose whether you want to translate from natural language to SQL or from SQL to natural language. Then, type in your query and hit the \"translate\" button. The tool will generate the corresponding code or text and display it on the screen. \nYou can press the 'reverse' button to give input as Natural Language and get SQL queries in response\n\n\n## 🎯 Roadmap\n\n- [ ] Functions (WIP)\n- [ ] Procedures\n\n\n## 🛠️ Installation\n\n### Local Development Environment\n\n1. Clone the repository:\n\n    ```bash\n    git clone https://github.com/whoiskatrin/sql-translator.git\n    ```\n\n2. Install the required packages:\n\n    ```bash\n    cd sql-translator\n    npm install\n    ```\n\n3. Build the application:\n\n    ```bash\n    npm run build\n    ```\n\n4. Input your OPENAI API key in the .env file, you can get your API key [here](https://beta.openai.com/account/api-keys):\n\n    ```bash\n    OPENAI_API_KEY=$YOUR_API_KEY\n    ```\n\n5. Start the development server:\n\n    ```bash\n    npm start\n    ```\n\n### Docker Compose\n\n1. Clone the repository:\n\n    ```bash\n    git clone https://github.com/whoiskatrin/sql-translator.git\n    ```\n\n2. Input your OPENAI API key in the .env.production file, you can get your API key [here](https://beta.openai.com/account/api-keys):\n\n    ```bash\n    OPENAI_API_KEY=$YOUR_API_KEY\n    ```\n\n3. Start the development server:\n\n    ```bash\n    docker-compose up\n    ```\n\n## 🖥️ Usage\n\nOnce the development server is running, you can access the application by navigating to `http://localhost:3000` in your web browser.\n\nEnter a natural language query in the input box and click \"Translate\" to generate the corresponding SQL code. The generated SQL code will be displayed in the output box.\n\n## 👥 Contributing\n\nContributions to SQL Translator are welcome and encouraged! To contribute, please follow these steps:\n\n1. Fork the repository\n2. Create a new branch\n3. Make your changes\n4. Push your changes to your fork\n5. Submit a pull request\n\n## 📜 License\n\nSQL Translator is released under the MIT [License](LICENSE).\n","funding_links":[],"categories":["TypeScript","HarmonyOS","A01_文本生成_文本对话"],"sub_categories":["Windows Manager","大语言对话模型及数据"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhoiskatrin%2Fsql-translator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwhoiskatrin%2Fsql-translator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhoiskatrin%2Fsql-translator/lists"}