README.md

---
title: LangGraph Groq Assistant
emoji: 🤖
colorFrom: purple
colorTo: indigo
sdk: gradio
sdk_version: 5.25.0
app_file: app.py
pinned: false
license: mit
---

# LangGraph × Groq General Assistant

A stateful conversational AI chatbot built with:

| Component | Role |
|-----------|------|
| **LangGraph** | Manages conversation graph / state |
| **Groq** | Ultra-fast LLM inference (Llama 3, Mixtral, Gemma) |
| **Gradio 5** | Web UI, deployable on Hugging Face Spaces |

## 🚀 Quick Start

1. Clone this Space or run locally
2. Enter your [Groq API key](https://console.groq.com) (free tier available)
3. Pick a model, optionally edit the system prompt
4. Start chatting!

## 🔧 Local Setup

```bash
pip install -r requirements.txt
pip install "gradio>=5.25.0"
python app.py
```

## 📝 Compatibility Notes

- **Gradio version** is controlled by `sdk_version` in this README — not by `requirements.txt`
- **`audioop-lts`** in requirements.txt backports the `audioop` stdlib module removed in Python 3.13, which pydub (a Gradio dep) needs
- **`huggingface_hub>=1.0`** required because Gradio 5.25+ dropped the old `HfFolder` API that was removed in hub v1.0