https://github.com/darkdk123/ai-chatbot
A simple LangChain AI ChatBot with HuggingFace and Streamlit.
https://github.com/darkdk123/ai-chatbot
Last synced: 3 months ago
JSON representation
A simple LangChain AI ChatBot with HuggingFace and Streamlit.
- Host: GitHub
- URL: https://github.com/darkdk123/ai-chatbot
- Owner: DarkDk123
- Created: 2024-11-29T17:19:19.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-03-29T21:59:37.000Z (6 months ago)
- Last Synced: 2025-03-29T22:28:05.312Z (6 months ago)
- Language: Python
- Size: 1.95 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AI-ChatBot
An Intuitive AI-ChatBot with HuggingFace and LangChain impersonating Rajneesh OSHO, a great mystic.
AI-ChatBot is a simple AI-ChatBot leveraging **HuggingFace** inference endpoint and **LangChain**
to generate text based on input prompts. It supports **multi-thread conversations** for single user &
**`LangGraph's persistent memory`** for contextual & intuitive responses.
It currently uses ***in-memory*** storage, so volatile for single run!
## Images
**Streamlit UI**
## Components Used
- 🐍[Python 3.10+](https://www.python.org/downloads/) - You know the beast 😇
- 🦜⛓️ [LangChain](https://langchain.com/) (with [LangGraph](https://www.langchain.com/langgraph)) - Framework for LLM Applications development & orchestration.
- 🤗 [HuggingFace](https://huggingface.co/) (with [HuggingFace Inference API](https://api-inference.huggingface.co/)) - A library for natural language processing tasks and API for model inference.
- ⚡ [Groq API](https://console.groq.com/playground) - Ultra-fast inference API for running LLMs, supported as a primary backend option for this chatbot.
- 👑 [Streamlit](https://streamlit.io/) - A framework for building web applications for machine learning and data science.
## How to Use Locally
You can run the chatbot **locally** (default, recommended) or with **Docker** (coming soon).
**Local mode uses only temporary `in-memory storage`—conversations are lost on restart.** 🫧
> Some architectural changes are in progress to run **Local/Dockerized** applications smoothly. [May take time] ⏳
🔹 Local (Recommended)
1. **Clone the repository**:
```bash
git clone https://github.com/DarkDk123/AI-ChatBot
cd AI-ChatBot
```
2. **Set up a virtual environment**:
```bash
python3 -m venv .venv
source .venv/bin/activate
```
3. **Install dependencies**:
```bash
pip install uv # It's fast
uv pip install -r src/UI/requirements.txt
```
4. **Configure environment variables**:
Create a `.env` file and add your Groq API token and model ID. (see [`.env.local.example`](.env.local.example))
5. **Run the Streamlit app**:
```bash
python -m streamlit run src/UI/main_streamlit.py
```
6. **Access the service**:
Open your browser and navigate to **`http://localhost:8501`** to access the **AI-ChatBot** Service.
🐳 Docker (Coming Soon)
Docker support is under development and not ready yet. Stay tuned for updates!