README.md

---
title: StackLogix Chatbot
emoji: 🤖
colorFrom: purple
colorTo: blue
sdk: docker
app_port: 7860
pinned: false
---

# StackLogix Intelligent Chatbot

An AI-powered chatbot for StackLogix jewellery software, built with FastAPI + LangGraph + Qdrant + Groq.

## How to Run Locally

### 1. Navigating to the Project Root
Make sure you are in the project root directory, not inside the `app` folder.

```bash
cd c:\Users\jashd\Desktop\web_chatbot
```

### 2. Install Dependencies
```bash
pip install -r requirements.txt
```

### 3. Start the Server
Run this command from the project root:

```bash
python -m uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
```

Then open http://localhost:8000 in your browser.

## API Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| `POST` | `/chat/stream` | Streaming chat (SSE) |
| `POST` | `/chat` | Non-streaming chat (JSON) |
| `GET`  | `/chats` | List all chat sessions |
| `GET`  | `/chats/{session_id}` | Get history for a specific session |
| `POST` | `/ingest` | Trigger document ingestion |
| `GET`  | `/health` | Health check |
| `GET`  | `/docs` | Swagger API documentation |