A comprehensive AI-driven platform that combines Qloo's Taste AIβ’ API for cultural intelligence with Google Gemini AI for strategic PR campaign analysis. Built for data-driven marketing professionals who need location-specific cultural insights and automated PR strategy generation.
- Qloo API Integration: Real-time cultural intelligence from Qloo's Taste AIβ’ API
- Global Location Support: Analyze any location worldwide with cultural insights
- Demographic Analysis: Age-based brand engagement and cultural preferences
- Brand Affinity Mapping: Cultural relevance scores and popularity metrics
- Google Gemini AI: Advanced analysis using Gemini 2.0 Flash
- Comprehensive PR Strategy: 10 essential PR categories covered
- Automated Campaign Planning: Generate complete PR strategies from cultural data
- Interactive AI Chatbot: Get real-time assistance and strategy refinement
- Interactive Visualizations: Dynamic charts using Chart.js
- Cultural Relevance Scoring: Multi-dimensional cultural alignment metrics
- Location Intelligence: Top locations with cultural evidence
- Real-Time Data Processing: Live API responses, no hardcoded data
- React 18 + Vite: Fast, modern development stack
- Tailwind CSS: Beautiful, responsive design
- Mobile-First Design: Optimized for all devices
- Smooth Animations: Professional UI with engaging interactions
- Brand Analysis - Cultural positioning and brand perception
- Competitive Intelligence - Market competitor insights and positioning
- Geographic Intelligence - Location-based market opportunities
- Demographic Analysis - Target audience cultural preferences
- Influencer Discovery - Cultural influencer identification and matching
- Venue & Media Discovery - Strategic venue and media outlet recommendations
- Cultural Partnerships - Cultural collaboration opportunities
- Trending Analysis - Cultural trend identification and relevance
- Content Intelligence - Content strategy optimization based on cultural insights
- Crisis Management - Risk assessment and cultural sensitivity analysis
- React 18 - Modern UI framework with hooks
- Vite - Lightning-fast build tool and dev server
- Tailwind CSS - Utility-first CSS framework
- React Router DOM - Client-side routing
- Chart.js - Interactive charts and graphs
- React-Chartjs-2 - React wrapper for Chart.js
- Google Gemini AI - Advanced AI analysis (gemini-2.0-flash)
- Qloo Taste AIβ’ API - Cultural intelligence and demographic data
- Real-time API Integration - Live data processing and analysis
- Lucide React - Beautiful, consistent iconography
- React Hot Toast - User notifications and feedback
- React Dropzone - File upload functionality
- ESLint - Code quality and consistency
- PostCSS - CSS processing and optimization
- Node.js (v16 or higher)
- npm or yarn
-
Clone the repository
git clone https://github.com/newturk/NexPR.git cd NexPR -
Install dependencies
npm install
-
Configure environment variables Create a
.envfile in the root directory:VITE_GEMINI_API_KEY=your_gemini_api_key_here VITE_QLOO_API_KEY=your_qloo_api_key_here VITE_QLOO_BASE_URL=https://hackathon.api.qloo.com
-
Start development server
npm run dev
-
Open in browser Navigate to
http://localhost:5173
- Enter your brand name, product details, and category
- Specify target location (any global location supported)
- Set campaign scope and budget range
- Add additional notes and upload supporting files
- Click "Generate PR Campaign Analysis"
- System automatically queries Qloo API for cultural intelligence
- Gemini AI analyzes cultural data and generates comprehensive strategy
- Real-time processing with progress indicators
- View comprehensive PR strategy with cultural insights
- Explore interactive charts and visualizations
- Access location-specific recommendations
- Use AI chatbot for strategy refinement
- Interactive chatbot for Q&A about your campaign
- Get additional insights and recommendations
- Refine strategy based on cultural intelligence
| Variable | Description | Required | Default |
|---|---|---|---|
VITE_GEMINI_API_KEY |
Google Gemini AI API key | Yes | - |
VITE_QLOO_API_KEY |
Qloo Taste AIβ’ API key | Yes | - |
VITE_QLOO_BASE_URL |
Qloo API base URL | No | https://hackathon.api.qloo.com |
The platform integrates with:
- Qloo API: Cultural intelligence and demographic data
- Google Gemini AI: Strategy generation and analysis
Market_Analysis/
βββ src/
β βββ components/
β β βββ AnalysisResults.jsx # Analytics dashboard and results
β β βββ CampaignBuilder.jsx # Campaign form and setup
β β βββ Chatbot.jsx # AI assistant chatbot
β β βββ Header.jsx # Navigation header
β β βββ RobotLoader.jsx # Loading animations
β βββ services/
β β βββ enhancedQlooService.js # Qloo API integration
β β βββ geminiService.js # Gemini AI integration
β β βββ qlooTypes.js # Type definitions
β βββ App.jsx # Main application component
β βββ main.jsx # Application entry point
β βββ index.css # Global styles
βββ package.json
βββ vite.config.js
βββ README.md
- Global Location Support: Analyze any location worldwide
- Real Cultural Data: No hardcoded data - all insights from live APIs
- Demographic Insights: Age-based cultural preferences and engagement
- Brand Affinity Analysis: Cultural relevance and popularity metrics
- Comprehensive Analysis: 10 essential PR categories covered
- Location-Specific Recommendations: Tailored strategies for target markets
- Cultural Sensitivity: Risk assessment and cultural alignment
- Automated Planning: Generate complete PR strategies from cultural data
- Real-Time Processing: Live API queries and analysis
- Visual Analytics: Interactive charts and data visualization
- AI Assistant: Chatbot for strategy refinement and Q&A
- Responsive Design: Works seamlessly across all devices
- Environment Variables: API keys stored securely
- No Data Storage: Sensitive data not logged or stored
- Secure API Communication: Proper headers and authentication
- Client-Side Validation: Input validation and sanitization
- Connect GitHub repository to Netlify
- Set environment variables in Netlify dashboard
- Deploy automatically on push to main branch
- Import GitHub repository to Vercel
- Configure environment variables
- Deploy with automatic CI/CD
npm run build
# Upload dist/ folder to your hosting provider- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Qloo for providing the Taste AIβ’ API and hosting the LLM Hackathon
- Google for Gemini AI capabilities and API access
- React and Vite communities for excellent development tooling
- Chart.js for beautiful data visualizations
Shubham Kumar - Built for Qloo LLM Hackathon
For support, create an issue in this repository or contact the author.
Built with β€οΈ for the Qloo LLM Hackathon