hp_chatbot/chat-interface/README.md
michael 594f749d4c Initial commit: HP Marketing Materials GraphRAG Chatbot
Full-stack GraphRAG chatbot for HP marketing materials with:
- Python/Flask backend with custom ReAct agent (LlamaIndex)
- Neo4j knowledge graph + vector search hybrid retrieval
- LlamaParse multimodal document processing (text + images)
- React/Vite frontend with conversation management
- MongoDB conversation persistence
- MSAL authentication support

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-23 08:37:58 -06:00

72 lines
No EOL
1.6 KiB
Markdown

# HP Marketing Materials Chatbot
A React frontend for the HP Marketing Materials Chatbot, providing a chat interface to query the HP marketing knowledge base.
## Features
- Clean chat interface for asking questions about HP marketing materials
- Sources and reasoning display for transparency
- Session-based memory for contextual conversations
- Conversation management system
## Development
### Prerequisites
- Node.js 18+
- npm or yarn
### Setup
1. Clone the repository
2. Install dependencies:
```bash
npm install
```
3. Start the development server:
```bash
npm run dev
```
### Configuration
The application uses environment variables for configuration. Create a `.env` file in the root directory with the following variables:
```
# Backend API URL
VITE_BACKEND_URL=https://ai-sandbox.oliver.solutions/hp_chatbot_back
# Base URL for the app (changes in production)
VITE_APP_BASE_URL=/
```
### Changing the Backend URL
If you need to change the backend API URL:
1. Edit the `.env` and `.env.production` files to update the `VITE_BACKEND_URL` value
2. Or use the provided script: `./update-backend.sh` which will update the URL and rebuild the application
3. Then rebuild the application with `npm run build`
## Building for Production
To create a production build:
```bash
npm run build
```
The output will be in the `dist` directory, ready for deployment.
## Deployment
See [DEPLOY.md](./DEPLOY.md) for detailed deployment instructions.
## Technologies Used
- React 18
- Vite
- TailwindCSS
- Microsoft Authentication Library (MSAL) or custom authentication
- Shadcn/ui components