/groq_streamlit_demo

Groq goes brrrrr... so had to make a basic Streamlit app you can build upon!

Primary LanguagePython

CI/CD Pipeline

Getting Started

Clone me and Run me 👇  

Try the Project quickly with Python Venv's:

python -m venv groqlit #create it

groqlit\Scripts\activate #activate venv (windows)
source groqlit/bin/activate #(linux)
pip install -r requirements.txt #all at once
streamlit run streamlit_app.py
  • Make sure to have ollama ready and running your desired model!
  • Prepare the API Keys in any of:
    • .streamlit/secrets.toml
    • As environment Variable
      • Linux - export OPENAI_API_KEY="YOUR_API_KEY"
      • CMD - set OPENAI_API_KEY=YOUR_API_KEY
      • PS - $env:OPENAI_API_KEY="YOUR_API_KEY"
      • Docker-Compose
    • Through the Streamlit UI

Groq Chat Streamlit App

Streamlit App

Demo App Screenshot

This Streamlit app integrates with the Groq API to provide a chat interface where users can interact with advanced language models. It allows users to choose between two models for generating responses, enhancing the flexibility and user experience of the chat application.

It is blazing FAST; try it and see! 🏎️ 💨 💨 💨

Check out the video tutorial 👇

Watch the video

Features

  • Model Selection: Users can select between mixtral-8x7b-32768, llama2-70b-4096, Gemma-7b-it, llama2-70b-4096, llama3-70b-8192, and lama3-8b-8192 models to tailor the conversation according to each model's capabilities.
  • Chat History: The app maintains a session-based chat history, allowing for a continuous conversation flow during the app session.
  • Dynamic Response Generation: Utilizes a generator function to stream responses from the Groq API, providing a seamless chat experience.
  • Error Handling: Implements try-except blocks to handle potential errors gracefully during API calls.

Requirements

  • Streamlit
  • Groq Python SDK
  • Python 3.7+

Setup and Installation

  • Install Dependencies:

    pip install streamlit groq
  • Set Up Groq API Key:

    Ensure you have an API key from Groq. This key should be stored securely using Streamlit's secrets management:

    # .streamlit/secrets.toml
    GROQ_API_KEY="your_api_key_here"
  • Run the App: Navigate to the app's directory and run:

streamlit run streamlit_app.py

Usage

Upon launching the app, you are greeted with a title and a model selection dropdown.

After choosing a preferred model, you can interact with the chat interface by entering prompts.

The app displays the user's questions and the AI's responses, facilitating a back-and-forth conversation.

Customization

The app can be easily customized to include additional language models (as Groq adds more), alter the user interface, or extend the functionality to incorporate other interactions with the Groq API.

Contributing

Contributions are welcome to enhance the app, fix bugs, or improve documentation.

Please feel free to fork the repository, make changes, and submit a pull request.