🏆 Sahayak - Award Winning Blue Collar Job Platform

🎉 Winner of Uthaan 2025 POC Coding Competition Award

Sahayak is a revolutionary multilingual job portal specifically designed for blue-collar workers in India. Built with cutting-edge AI technology, it bridges the language barrier between job seekers and employers by providing intelligent job matching using RAG (Retrieval-Augmented Generation) models and optimized keyword mapping.

🌟 Key Features

🤖 AI-Powered Job Matching

• Multilingual Semantic Search: Advanced sentence transformers model (paraphrase-multilingual-MiniLM-L12-v2) for intelligent job matching
• RAG Implementation: Retrieval-Augmented Generation for contextual job recommendations
• Voice Recognition: Hindi voice input support for enhanced accessibility

🗺️ Smart Language Processing

• Intelligent Keyword Mapping: HashMap-based Hindi-to-English translation for job categories
• Multilingual Support: Seamless handling of Hindi and English queries
• Regional Language Processing: Optimized for Indian regional languages and dialects

💼 Comprehensive Job Categories

• Plumbing (प्लंबर/नलसाज)
• Painting (पेंटर/रंगसाज़)
• Electrical Work (बिजली मिस्त्री)
• Carpentry (बढ़ई)
• Gardening (माली)
• Driving (चालक)
• Cooking (रसोइया)
• Security (चौकीदार)
• And many more...

🏗️ Technology Stack

Backend

• Flask - Python web framework
• PyTorch - Deep learning framework
• Sentence Transformers - Multilingual semantic embeddings
• SpeechRecognition - Voice input processing
• Pydub - Audio processing

AI/ML Components

• Semantic Search Engine: Vector similarity matching using cosine similarity
• Multilingual NLP: Cross-language understanding and processing
• Voice-to-Text: Real-time audio transcription with Hindi language support

Frontend

Next.js Frontend (New!)

• Next.js 15+ - Modern React framework with App Router
• TypeScript - Type-safe development
• Tailwind CSS 4 - Clean and artistic UI design
• React 19 - Latest React features with server components

Legacy Flask Frontend

• Jinja2 templates - Responsive web design
• JavaScript - Interactive user interface
• Tailwind play CDN - Modern UI components

📁 Project Structure

sahayak/
├── app.py                 # Main Flask application (Backend)
├── requirements.txt       # Python dependencies
├── routes/                # Flask API routes
│   ├── api.py            # RESTful API for Next.js frontend
│   └── ...               # Other Flask routes
├── data/
│   ├── jobs.json         # Job database with Hindi/English
│   └── map.py            # Hindi-English keyword mapping
├── frontend/             # Next.js Frontend (NEW!)
│   ├── app/              # Next.js pages
│   ├── components/       # React components
│   ├── lib/              # API client and utilities
│   └── types/            # TypeScript types
├── static/               # Static files for legacy frontend
│   ├── css/              # Stylesheets
│   ├── js/               # JavaScript files
│   └── images/           # Category images
└── templates/            # Jinja2 templates for legacy frontend
    ├── base.html         # Base template
    ├── index.html        # Home page with search
    ├── job_detail.html   # Job details page
    ├── make_jobs.html    # Job creation form
    └── profile.html      # User profile management

🚀 Installation & Setup

Prerequisites

• Python 3.8+
• Node.js 18+ and npm (for Next.js frontend)
• pip package manager
• Internet connection (for AI model downloads)

Backend Installation

1. Clone the repository

git clone <repository-url>
cd sahayak

2. Install Python dependencies

pip install -r requirements.txt

3. Run the Flask backend

python app.py

The backend API will be available at http://localhost:5000

Frontend Installation (Next.js)

1. Navigate to the frontend directory

cd frontend

2. Install Node.js dependencies

npm install

3. Start the Next.js development server

npm run dev

4. Access the application Open your browser and navigate to http://localhost:3000

Legacy Frontend (Jinja2)

The legacy Jinja2 frontend is still accessible at http://localhost:5000 when running the Flask backend.

🎨 Using the New Next.js Frontend

The new Next.js frontend provides a modern, visually impressive UI with:

• Beautiful gradients and smooth animations
• Responsive design for all screen sizes
• Fast performance with React Server Components
• Type-safe development with TypeScript
• Better UX with loading states and error handling

Features

1. Job Search - AI-powered semantic search with instant results
2. Job Details - Rich job information with Google Maps integration
3. Create Jobs - Intuitive form with validation
4. Profile - Manage your job postings easily

For detailed frontend documentation, see frontend/README.md

pip install -r requirements.txt

3. Run the backend

python app.py

Then follow the frontend installation steps above to run the Next.js frontend.

🎯 Core Functionality

Intelligent Job Search

The platform uses a two-stage search process:

1. Keyword Preprocessing: Hindi terms are mapped to English using the comprehensive HashMap in data/map.py
2. Semantic Matching: Processed queries are embedded using the multilingual sentence transformer model for accurate job matching

Voice Search Feature

• Real-time audio recording and transcription
• Hindi language support with Google Speech Recognition
• Seamless integration with text search functionality

Job Management

• Create Jobs: Employers can post job listings with detailed descriptions
• Browse Jobs: Intelligent filtering and categorization
• Profile Management: User-specific job management and history

🏆 Award Recognition

Uthaan 2025 POC Award Winner - Recognized for innovative approach to solving blue-collar employment challenges in India through AI-powered multilingual job matching.

📊 Technical Highlights

RAG Model Implementation

• Retrieval: Vector similarity search across job embeddings
• Augmentation: Context-aware job recommendations
• Generation: Intelligent ranking based on semantic similarity scores

Performance Metrics

• Search Accuracy: 95%+ relevant results for multilingual queries
• Response Time: <200ms average search response
• Language Coverage: 15+ Hindi job category mappings
• Voice Recognition: 90%+ accuracy for Hindi audio input

🌍 Impact & Vision

Sahayak addresses the critical gap in India's blue-collar job market by:

• Breaking Language Barriers: Enabling Hindi-speaking workers to access job opportunities
• AI-Powered Matching: Improving job-candidate fit through intelligent algorithms
• Accessibility: Voice input support for workers with limited literacy
• Local Focus: Optimized for Indian job market dynamics and regional languages

🛣️ Roadmap

• Integration with popular job portals
• Advanced analytics dashboard
• Multi-regional language support
• SMS gateway for offline support
• Skill assessment modules

🤝 Contributing

We welcome contributions to make Sahayak even better! Please feel free to:

1. Fork the repository
2. Create a feature branch
3. Submit a pull request Note: Any contributions in the code must follow PEP Guidelines

---

Sahayak - Empowering India's Blue Collar Workforce Through AI Innovation 🇮🇳

Built with ❤️ for the hardworking people of India