MCP Chat Support System

<<<<<<< HEAD

ClientSphere

AI-Powered Chatbot & CRM Platform - Transform customer relationships with intelligent conversations.

🚀 Features

Frontend (React + TypeScript)

• Modern UI/UX: Responsive design with mobile optimization
• AI Chat: Powered by Google Gemini for intelligent responses
• Knowledge Base: Upload PDFs and documents for AI context
• CRM Dashboard: Manage customer relationships
• Multi-tenant: Support multiple businesses/brands
• Real-time Analytics: Track conversations and insights
• Widget System: Embeddable chat widgets for websites

Backend (Cloudflare Workers)

• Serverless API: Fast, globally distributed
• Supabase Integration: PostgreSQL database
• Authentication: JWT + Google OAuth
• File Processing: PDF text extraction
• Knowledge Base API: Document management

📁 Project Structure

clientsphere/
├── src/                    # React frontend
│   ├── components/         # Reusable UI components
│   ├── pages/             # Page components
│   │   ├── auth/          # Login, Signup
│   │   ├── admin/         # Admin dashboard
│   │   └── tenant/        # Tenant dashboard
│   ├── context/           # React contexts
│   ├── hooks/             # Custom React hooks
│   ├── lib/               # Utility functions
│   └── types/             # TypeScript definitions
├── mcp-backend/           # Cloudflare Worker backend
├── gemini-mcp-server/     # Python AI Server (Hugging Face)
├── public/                # Static assets
└── dist/                  # Built frontend

🛠️ Tech Stack

Frontend

• React 18 with TypeScript
• Vite for build tooling
• Tailwind CSS for styling
• Framer Motion for animations
• React Router for navigation
• Radix UI for components

Backend

• Cloudflare Workers (Serverless)
• Supabase (PostgreSQL + Auth)
• Google Gemini AI for chat
• JWT for authentication

🚀 Quick Start

Prerequisites

• Node.js 18+
• npm or yarn

Installation

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

Environment Variables

Create a .env.local file:

VITE_API_URL=https://your-backend.workers.dev
VITE_GEMINI_MCP_URL=https://your-ai-server.hf.space
VITE_GOOGLE_CLIENT_ID=your-google-client-id
VITE_APP_NAME=ClientSphere
VITE_APP_VERSION=1.0.0

🌐 Deployment

Frontend (Cloudflare Pages)

npm run build
npx wrangler pages deploy dist --project-name=clientsphere

Backend (Cloudflare Workers)

cd mcp-backend
npx wrangler deploy

📊 API Endpoints

🎨 Screenshots

• Landing Page: Modern, animated hero section
• Dashboard: Analytics and quick actions
• Knowledge Base: Upload and manage documents
• Live Chat: Test AI responses in real-time

📄 License

MIT License - see LICENSE for details.

---

<<<<<<< HEAD ClientSphere - Your customers, connected. 🌐

Made with ❤️ by Chirag

7c7c9ed51d81813405e7ded2f90e85d31ab34c6b =======

---

title: RAG Backend emoji: 🚀 colorFrom: pink colorTo: indigo sdk: docker pinned: false

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

c7164f2c30d7155283c30c509405593b5f517157