{"id":49699117,"url":"https://github.com/abs-futy7/text2query","last_synced_at":"2026-05-08T06:03:36.787Z","repository":{"id":326129977,"uuid":"1104118560","full_name":"Abs-Futy7/Text2Query","owner":"Abs-Futy7","description":"AI-powered Text-to-SQL engine that converts natural language into accurate database queries.","archived":false,"fork":false,"pushed_at":"2025-11-25T19:32:38.000Z","size":316,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-29T00:53:03.005Z","etag":null,"topics":["fastapi","groq","langchain","nextjs"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/Abs-Futy7.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-25T19:25:46.000Z","updated_at":"2025-11-25T19:34:52.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Abs-Futy7/Text2Query","commit_stats":null,"previous_names":["abs-futy7/text2query"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Abs-Futy7/Text2Query","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abs-Futy7%2FText2Query","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abs-Futy7%2FText2Query/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abs-Futy7%2FText2Query/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abs-Futy7%2FText2Query/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Abs-Futy7","download_url":"https://codeload.github.com/Abs-Futy7/Text2Query/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abs-Futy7%2FText2Query/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32769110,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T02:36:36.067Z","status":"ssl_error","status_checked_at":"2026-05-08T02:36:07.210Z","response_time":54,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["fastapi","groq","langchain","nextjs"],"created_at":"2026-05-08T06:03:32.561Z","updated_at":"2026-05-08T06:03:36.772Z","avatar_url":"https://github.com/Abs-Futy7.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Text2Query\n\nText2Query is an AI-powered web application that converts natural language questions into SQL queries for your CSV data. Upload your dataset, ask questions in plain English, and get instant, accurate SQL queries and results—no SQL expertise required.\n\n---\n\n## Features\n- **AI-Powered Text-to-SQL:** Converts natural language to SQL using LLMs (Groq, LangChain, etc.)\n- **CSV Upload:** Securely upload your CSV file and explore its data structure\n- **Instant Querying:** Ask questions and get SQL + results instantly\n- **Modern UI:** Beautiful, responsive frontend with a professional purple theme (Next.js, Tailwind CSS)\n- **Backend API:** FastAPI backend for CSV ingestion and LLM-powered SQL generation\n\n---\n\n## Screenshots\n\u003cp align=\"center\"\u003e\n\t\u003cimg src=\"./screenshots/image.png\" alt=\"Text2Query App Screenshot\" width=\"full\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003ci\u003eText2Query – AI-powered text-to-SQL web app\u003c/i\u003e\u003c/p\u003e\n\n---\n\n## Getting Started\n\n### Prerequisites\n- Node.js (for frontend)\n- Python 3.10+ (for backend)\n- [Groq API Key](https://console.groq.com/) (for LLM-powered SQL)\n\n### 1. Clone the Repository\n```bash\ngit clone https://github.com/Abs-Futy7/Text2Query.git\ncd Text2Query\n```\n\n### 2. Backend Setup\n```bash\ncd backend\npython -m venv .venv\n.venv\\Scripts\\activate  # On Windows\npip install -r requirements.txt\n```\n\nCreate a `.env` file in `backend/` with your Groq API key:\n```\nGROQ_API_KEY=your_groq_api_key_here\n```\n\nStart the backend server:\n```bash\nuvicorn server:app --reload --port 8000\n```\n\n### 3. Frontend Setup\n```bash\ncd ../frontend\nnpm install\nnpm run dev\n```\n\nVisit [http://localhost:3000](http://localhost:3000) to use the app.\n\n---\n\n## Usage\n1. **Upload CSV:** Click \"Upload CSV\" and select your data file.\n2. **Ask Questions:** Go to \"Query Data\" and type your question in plain English.\n3. **Get SQL \u0026 Results:** Instantly see the generated SQL and query results.\n\n---\n\n## Project Structure\n```\nText2Query/\n├── backend/      # FastAPI backend, LLM logic, database\n├── frontend/     # Next.js frontend, UI components\n├── screenshots/  # App screenshots (add your own)\n└── students.csv  # Example CSV file\n```\n\n---\n\n## Technologies Used\n- **Frontend:** Next.js, React, Tailwind CSS\n- **Backend:** FastAPI, LangChain, Groq, Uvicorn, Pandas\n- **LLM:** Groq API (LLM for text-to-SQL)\n\n---\n\n## Security\n- **Never commit your `.env` or API keys to git.**\n- Add `backend/.env` to `.gitignore` (already included).\n- If a secret is accidentally committed, follow [GitHub's secret removal guide](https://docs.github.com/en/code-security/secret-scanning/removing-a-secret-that-has-been-committed-to-your-repository).\n\n---\n\n## License\n[MIT](LICENSE)\n\n---\n\n## Credits\n- Built by Abs-Futy7\n- Powered by Groq, LangChain, and the open-source community\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabs-futy7%2Ftext2query","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabs-futy7%2Ftext2query","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabs-futy7%2Ftext2query/lists"}