🦙 Alpaca - AI Chatbot using Groq API

Alpaca is a chill, interactive AI chatbot built using Streamlit and powered by the Groq API (LLaMA 3.1). It allows you to chat in a smooth, conversational interface, save/load chat history, and vibe with a cool assistant.

---

🚀 Features

• 🌐 Streamlit web interface with responsive design
• 🧠 LLaMa-3.1-8b-instant (Groq API)
• 💬 Persistent local chat history (chat_history.json)
• 🛠 Sidebar tools: Save, Load, Clear history
• 🔒 API key handled via config or environment variable
• 🖼️ Lottie animation for aesthetics
• 🪵 Logging and error handling for reliability

---

📦 Setup Instructions

1. Clone the repository

   git clone https://github.com/KaisoX24/LLama.git
   cd LLama
   

2. Create and activate a virtual environment

   python -m venv venv
   venv\Scripts\activate   #on Mac source venv/bin/activate
   

3. Install the Dependencies

   pip install -r requirements.txt
   

4. Add Your API Key

   {
   "GROQ_API_KEY": "your_groq_api_key_here"
   }
   

5. Run the APP

   streamlit run main.py
   

---

📦 Project Structure

LLama/
├── app.py                 # Main Streamlit application
├── config.json            # API key config file (not tracked)
├── chat_history.json      # Chat logs saved locally
├── requirements.txt       # Python dependencies

---

🛠️ Tech Stack

Technology	Purpose
Python	Core programming language
Streamlit	Frontend Web App framework
Groq API	For using the llama-3.1-8b-instant model
Lottie Animations	Animated visuals
JSON	For configuration and saving chat history
Logging (Python standard library)	For error tracking and debug logging

---

🧠 Credits

Developed by Pramit Acharjya.

---

📃 License

This project is licensed under the MIT License. Feel free to use, modify, and share!