LuxBrain AI - Installation Guide

Enterprise-grade AI-powered WhatsApp automation and e-commerce intelligence platform

Quick Installation (10 Minutes)

Prerequisites

  • Python 3.11+ (Download)
  • Node.js 18+ (Download) - For frontend
  • Git (Download)
  • PostgreSQL 15+ (Optional - SQLite included for development)
  • Redis 7+ (Optional - for production caching)

Step 1: Download Project

git clone https://github.com/luxbrainai/LuxBrainAI.git
cd LuxBrainAI

Step 2: Backend Setup

# Create virtual environment
python -m venv venv

# Activate environment
# Windows:
venv\Scripts\activate
# Linux/Mac:
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Setup environment
cp .env.example .env
# Edit .env with your configuration

Step 3: Database Setup

# Initialize database with demo data
python create_helpdesk_tables.py
python create_super_admin_simple.py

# Run database migrations (if using PostgreSQL)
alembic upgrade head

Step 4: Frontend Setup (Optional)

cd frontend
npm install
npm run build
cd ..

Step 5: Start Application

# Method 1: Full stack (Recommended)
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

# Method 2: Windows batch
start-helpdesk.bat

# Method 3: Development server
python start_helpdesk_server.py

Step 6: Access Applications

Demo Login Credentials

Super Admin

Client Admin

Helpdesk Staff

  • Email: support@luxebrainai.com
  • Password: Support@2025
  • Roles: Customer Support, Technical Support, Billing Support

What You Get

🤖 AI Chat Engine

  • GPT-powered customer support
  • Multi-language support
  • Custom AI training capabilities
  • Intelligent response suggestions

📱 WhatsApp Automation

  • Selenium-based message handling
  • Automated customer responses
  • Message scheduling and templates
  • Bulk messaging capabilities

🛒 E-commerce Integration

  • Shopify: Product sync, order management
  • WooCommerce: Inventory tracking, customer data
  • Stripe: Payment processing and billing
  • Real-time order notifications

📊 Analytics & Monitoring

  • Real-time performance metrics
  • Customer interaction analytics
  • Revenue tracking and reporting
  • System health monitoring

🎫 Complete Helpdesk System

  • Multi-channel support tickets
  • Real-time CSR chat interface
  • Automated ticket routing
  • SLA tracking and escalation

🏢 Enterprise Features

  • Multi-tenant architecture
  • Role-based access control (RBAC)
  • JWT authentication & encryption
  • Audit logging and compliance

🚀 Scalable Infrastructure

  • Kubernetes-ready deployment
  • Docker containerization
  • Redis caching layer
  • PostgreSQL/SQLite database support

Testing the System

1. Super Admin Dashboard

  1. Login with super admin credentials
  2. Manage companies and users
  3. View system analytics
  4. Configure billing and services

2. Client Dashboard

  1. Login as client admin
  2. View company analytics
  3. Manage team members
  4. Configure integrations

3. Helpdesk System

  1. Login as CSR staff
  2. Handle support tickets
  3. Chat with customers
  4. Update ticket status

4. E-commerce Integration

  1. Configure Shopify/WooCommerce
  2. Test product synchronization
  3. Monitor order processing
  4. Verify payment integration

5. WhatsApp Automation

  1. Setup WhatsApp Web connection
  2. Configure automated responses
  3. Test message templates
  4. Monitor conversation analytics

API Testing

# Test core functionality
python test_helpdesk_api.py
python quick-test.py

# Test full stack integration
python test-full-stack.py

# Validate system health
curl http://localhost:8000/health

Technical Stack

🔧 Backend Technologies

  • Framework: FastAPI, SQLAlchemy, Alembic
  • Database: PostgreSQL, SQLite (development)
  • Caching: Redis
  • Authentication: JWT, OAuth2
  • API: RESTful with OpenAPI documentation

🎨 Frontend Technologies

  • Framework: Next.js, React, TypeScript
  • Styling: Tailwind CSS, Responsive Design
  • State Management: React Hooks, Context API
  • Build Tools: Webpack, ESLint, Prettier

🤖 AI & Automation

  • AI Engine: OpenAI GPT, Transformers
  • WhatsApp: Selenium WebDriver automation
  • E-commerce: Shopify API, WooCommerce REST API
  • Payments: Stripe SDK

🚀 DevOps & Deployment

  • Containerization: Docker, Docker Compose
  • Orchestration: Kubernetes
  • Monitoring: Prometheus, Grafana
  • CI/CD: GitHub Actions

Production Deployment

Docker Deployment

# Production environment
docker-compose -f infrastructure/docker-compose.prod.yml up -d

# Kubernetes deployment
kubectl apply -f infrastructure/k8s/

Manual Production Setup

# Set production environment
export ENVIRONMENT=production
export DATABASE_URL=postgresql://user:pass@host:5432/luxbrain_ai
export REDIS_URL=redis://host:6379

# Run with gunicorn
gunicorn app.main:app -w 4 -k uvicorn.workers.UvicornWorker

Need Help?

Next Steps

Integration

  • Connect your Shopify/WooCommerce store
  • Setup WhatsApp Business API
  • Configure payment gateways
  • Integrate with existing CRM

Customization

  • Brand the interface with your colors/logo
  • Configure AI responses for your business
  • Setup custom workflows and automations
  • Add team members and permissions

Scaling

  • Deploy to cloud infrastructure
  • Setup monitoring and alerts
  • Configure backup and disaster recovery
  • Implement load balancing