https://github.com/kaarthik108/snowchat

Chat snowflake - Text to SQL
https://github.com/kaarthik108/snowchat

agents chatgpt langchain langgraph llama snowflake snowpark streamlit supabase

Last synced: about 18 hours ago
JSON representation

Chat snowflake - Text to SQL

• Host: GitHub
• URL: https://github.com/kaarthik108/snowchat
• Owner: kaarthik108
• Created: 2023-04-10T23:31:01.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2025-02-16T19:23:23.000Z (about 2 months ago)
• Last Synced: 2025-04-07T10:17:59.784Z (8 days ago)
• Topics: agents, chatgpt, langchain, langgraph, llama, snowflake, snowpark, streamlit, supabase
• Language: Python
• Homepage: https://snowchat.streamlit.app/
• Size: 207 KB
• Stars: 518
• Watchers: 15
• Forks: 274
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml

Awesome Lists containing this project

• awesome-ChatGPT-repositories - snowChat - Chat on you're snowflake database - Text to SQL (Langchain)

README

        
# snowChat 💬❄️

[![Streamlit](https://img.shields.io/badge/-Streamlit-FF4B4B?style=flat-square&logo=streamlit&logoColor=white)](https://streamlit.io/)

[![OpenAI](https://img.shields.io/badge/-OpenAI-412991?style=flat-square&logo=openai&logoColor=white)](https://openai.com/)

[![Snowflake](https://img.shields.io/badge/-Snowflake-29BFFF?style=flat-square&logo=snowflake&logoColor=white)](https://www.snowflake.com/en/)

[![Supabase](https://img.shields.io/badge/-Supabase-00C04A?style=flat-square&logo=supabase&logoColor=white)](https://www.supabase.io/)

[![AWS](https://img.shields.io/badge/-AWS-232F3E?style=flat-square&logo=amazon-aws&logoColor=white)](https://aws.amazon.com/)

[![Langchain](https://img.shields.io/badge/-Langchain-gray?style=flat-square)](https://www.langchain.com/)

[![Streamlit App](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://snowchat.streamlit.app/)

![156shots_so](https://github.com/kaarthik108/snowChat/assets/53030784/7538d25b-a2d4-4a2c-9601-fb4c7db3c0b6)

**snowChat** is an intuitive and user-friendly application that allows users to interact with their Snowflake data using natural language queries. Type in your questions or requests, and SnowChat will generate the appropriate SQL query and return the data you need. No more complex SQL queries or digging through tables - SnowChat makes it easy to access your data! By bringing data one step closer, SnowChat empowers users to make data-driven decisions faster and more efficiently, reducing the barriers between users and the insights they seek.

## Supported LLM's

- GPT-4o

- Gemini Flash 1.5 8B

- Claude 3 Haiku

- Llama 3.2 3B

- Llama 3.1 405B

#

https://github.com/kaarthik108/snowChat/assets/53030784/24105e23-69d3-4676-b6d6-d8157dd1580a

#

## 🌟 Features

- **Conversational AI**: Use ChatGPT and other models to translate natural language into precise SQL queries.

- **Conversational Memory**: Retains context for interactive, dynamic responses.

- **Snowflake Integration**: Offers seamless, real-time data insights straight from your Snowflake database.

- **Self-healing SQL**: Proactively suggests solutions for SQL errors, streamlining data access.

- **Interactive User Interface**: Transforms data querying into an engaging conversation, complete with a chat reset option.

- **Agent-based Architecture**: Utilizes an agent to manage interactions and tool usage.

## 🛠️ Installation

1. Clone this repository:

   git clone https://github.com/yourusername/snowchat.git

2. Install the required packages:

   cd snowchat

   pip install -r requirements.txt

3. Set up your `OPENAI_API_KEY`, `ACCOUNT`, `USER_NAME`, `PASSWORD`, `ROLE`, `DATABASE`, `SCHEMA`, `WAREHOUSE`, `SUPABASE_URL` , `SUPABASE_SERVICE_KEY`, `SUPABASE_STORAGE_URL`,`CLOUDFLARE_ACCOUNT_ID`, `CLOUDFLARE_NAMESPACE_ID`,

   `CLOUDFLARE_API_TOKEN` in project directory `secrets.toml`.

   Cloudflare is used here for caching Snowflake responses in KV.

4. Make you're schemas and store them in docs folder that matches you're database.

5. Create supabase extention, table and function from the supabase/scripts.sql.

6. Run `python ingest.py` to get convert to embeddings and store as an index file.

7. Run the Streamlit app to start chatting:

   streamlit run main.py

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=kaarthik108/snowChat&type=Date)]

## 🤝 Contributing

Feel free to contribute to this project by submitting a pull request or opening an issue. Your feedback and suggestions are greatly appreciated!

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](https://choosealicense.com/licenses/mit/) file for details.