SQLzilla leverages the power of Python and AI to simplify data access through natural language SQL query generation, bridging the gap between complex data queries and users with minimal programming experience.
SQLzilla is an innovative project that transforms the way users interact with databases. By integrating with InterSystems IRIS, we've crafted a tool that allows even those unfamiliar with SQL to effortlessly extract and analyze data across various tables.
Our solution is designed to democratize data access, enabling users from diverse backgrounds—whether they be business analysts, managers, or educational professionals—to harness the full potential of data without the need to master technical query languages. Additionally, SQLzilla offers experienced users the ability to accelerate their workflow, enhancing productivity through its intuitive interface and powerful AI-driven capabilities.
We believe SQLzilla is not just a tool, but a movement towards more inclusive and empowered data interaction. Our project is rooted in the philosophy that access to data should be straightforward and barrier-free, opening up opportunities for more informed decision-making and innovative insights in organizations of all sizes.
We hope that SQLzilla serves as a catalyst for change, making data more accessible than ever and inspiring a new wave of users to engage with technology in meaningful ways.
Join us in redefining data interaction and expanding the possibilities of what we can achieve with information at our fingertips.
Ensure you have Git and Docker Desktop installed.
To utilize the Large Language Model (LLM) service, you'll need an API key. Currently, the project supports OpenAI's LLM service.
Obtain your OpenAI API key by creating an account on their platform.
Environment variables are used to store sensitive information like API keys and tokens. These variables need to be set before building the Docker image.
There are two ways to configure these variables:
When launching the Docker container, you can set the OPENAI_KEY
environment variable using the -e
flag:
# OpenAI API key
export OPENAI_KEY=$OPENAI_KEY
Clone the repository into any local directory:
$ git clone https://github.com/musketeers-br/sqlzilla.git
Open the terminal in this directory and run:
$ docker-compose build --no-cache --progress=plain
$ docker-compose up -d
- Clone this repository.
- Install dependencies:
pip install -r python/sqlzilla/requirements.txt
- Run the app:
streamlit run python/sqlzilla/app.py
- Add a
.env
file with the API key. - Go to http://localhost:29999/.
- Go to http://localhost:8501/.
- Enter your OpenAI API key for the AI assistant you also can add a
.env
file with the API key. - Configure the database connection details (default configuration for docker user).
- Write SQL queries in the editor or chat window.
- Click "Execute" to run queries and see results.
Some prompts you can try:
- For 'Aviation' schema:
- what was the most deadly year?
- incident histogram by month/year
- For 'HoleFoods' schema:
- income by group
- most sold foods
- sales by product
- sales by product and category
sqlzilla_in_action.mp4
Our team is a group of passionate individuals dedicated to tackling complex challenges and slaying metaphorical giants (think Godzilla, not spreadsheets)