README.md

---
title: Client Chatbot
emoji: 💬
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
---

# Stacklogix Consultant Chatbot

A consultant-style chatbot for **Stacklogix** that gathers client requirements and explains how Stacklogix will address their needs. Powered by LangGraph + Groq (Llama 3.3 70B). Designed to be embedded on the Stacklogix website where clients interact with it instead of a sales representative.

## Features

- **Dual mode**: Handles both **clear requests** (e.g. build a chatbot, build a dashboard) and **problems or vague situations** (e.g. inventory moving slowly, issues with an existing project).
- **Structured requirement collection**: Asks relevant questions (e.g. type of deliverable, data and format, behavior, look and feel, constraints, expectations) in a natural, consultant-like flow.
- **Consultant-style explanations**: Explains how the problem will be addressed, high-level implementation or solution steps, and what the company will do to deliver or resolve the issue (and, for problems, prevent recurrence).
- **Domain-agnostic**: Works across technology, operations, business processes, inventory, and any other domain.
- **5-phase flow**: Discovery → Exploration → Constraints → Solution → Refinement, with session management and SQLite persistence.

## Flow

1. **Discovery** — Understand what the client wants or what is going wrong.
2. **Exploration** — Gather requirements: data, format, behavior, look, constraints, success criteria.
3. **Constraints** — Confirm understanding and explain the proposed approach.
4. **Solution** — Summarize needs, how you will address it, steps, and what you will deliver.
5. **Refinement** — Full proposal, implementation steps, and next steps.

Clients can start with a clear request (“we want to build X”) or a problem (“Y isn’t working”); the chatbot adapts its questions and explanations accordingly.