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>
72 lines
No EOL
1.6 KiB
Markdown
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 |