https://github.com/aravindhm97/aws-query-copilot
Translate plain English into powerful AWS Athena SQL queries. Built with FastAPI, Streamlit, Hugging Face Transformers, and Terraform — fully Dockerized and cloud-ready.
https://github.com/aravindhm97/aws-query-copilot
athena aws data-engineering docker fastapi huggingface llm nlp streamlit terraform
Last synced: 2 months ago
JSON representation
Translate plain English into powerful AWS Athena SQL queries. Built with FastAPI, Streamlit, Hugging Face Transformers, and Terraform — fully Dockerized and cloud-ready.
- Host: GitHub
- URL: https://github.com/aravindhm97/aws-query-copilot
- Owner: aravindhm97
- Created: 2025-07-16T07:23:57.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-07-17T04:18:07.000Z (11 months ago)
- Last Synced: 2025-07-25T18:29:04.612Z (11 months ago)
- Topics: athena, aws, data-engineering, docker, fastapi, huggingface, llm, nlp, streamlit, terraform
- Language: Python
- Homepage:
- Size: 47.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🧠 Query Copilot — Natural Language to Athena SQL
**Query Copilot** turns plain English into executable AWS Athena SQL queries using a Hugging Face model, FastAPI backend, and Streamlit frontend. Built for cloud-scale data exploration.
---
## 🚀 Features
- 🧠 Natural Language → SQL Translation (`defog/sqlcoder-7b-2`)
- ⚙️ FastAPI backend for model inference
- 🎨 Streamlit frontend UI
- 🐳 Docker & Docker Compose ready
- ☁️ AWS Terraform Infrastructure: S3, Athena, IAM
---
> ## 📝 Prerequisites
> Please check the [PREREQUISITES.md](./PREREQUISITES.md) file for a step-by-step installation guide on setting up all required tools.
---
> ## 📝 Deployment
> Please follow the [DEPLOYMENT.md](./DEPLOYMENT.md) file for the step-by-step detailed guide for installation.
---
### 📝 Example Prompts
- "Top 10 customers by purchase volume last quarter"
- "Orders from Bangalore in the last 7 days"
- "Revenue by region for 2023"
### 📁 Project Structure
```bash
query-copilot/
├── backend/
│ ├── api.py
│ ├── requirements.txt
│ ├── Dockerfile
│ └── .env
├── frontend/
│ ├── streamlit_app.py
│ ├── requirements.txt
│ ├── Dockerfile
│ └── .env
├── terraform/
│ ├── main.tf
│ ├── variables.tf
│ ├── terraform.tfvars
│ └── outputs.tf
└── docker-compose.yml
```
### 💡 Credits
Built with ❤️ by Aravindh — [LinedIn](https://www.linkedin.com/in/aravindhkumar-m1997/) | [GitHub](https://github.com/aravindhm97)