Skip to content

shivamshrma09/NeoRecruiter---AI-hr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

92 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ NeoRecruiter - Complete Career & Recruitment Ecosystem

React Node.js MongoDB Google Gemini

πŸ“‹ Overview

NeoRecruiter is a comprehensive career development and recruitment platform that combines AI-powered interviews with mentorship, hackathons, internships, and job opportunities. It serves both students seeking career growth and HR professionals looking for top talent.

🌟 What Makes NeoRecruiter Special?

For Students:

  • πŸ€– AI-Powered Mock Interviews: Practice with Google Gemini AI feedback
  • πŸ‘¨πŸ« Expert Mentorship: Connect with industry professionals from top companies
  • πŸ† Hackathons & Competitions: Participate in coding challenges and win prizes
  • πŸ’Ό Internship Opportunities: Find internships at leading tech companies
  • πŸ“š Career Resources: Access learning materials and career guidance
  • πŸ“Š Progress Tracking: Monitor your interview performance and improvement

For HR & Recruiters:

  • πŸ›‘οΈ Anti-Cheating System: Comprehensive monitoring and detection
  • πŸ“Š Real-time Analytics: Live insights and performance metrics
  • πŸ“§ Automated Reporting: Detailed candidate analysis via email
  • 🎯 Smart Candidate Matching: AI-powered candidate recommendations
  • πŸ“ˆ Interview Management: Complete interview lifecycle management

🌐 Live Demo

Service URL Credentials
Frontend neorecruiter.vercel.app -
Backend API neorecruiter-ai-hr.onrender.com -
Demo Login Use Frontend URL [email protected] / 1234567
Video Demo Google Drive -

✨ Key Features

πŸŽ“ Student Features

πŸ€– AI-Powered Mock Interviews

  • 🎯 Intelligent Scoring: Advanced AI evaluates responses using Google Gemini
  • ⚑ Real-time Feedback: Instant analysis and improvement suggestions
  • πŸ“ˆ Multi-criteria Assessment: Relevance, Content Depth, Communication Skills, Sentiment Analysis
  • 🎯 Role-Specific Questions: Personalized questions for different job roles
  • πŸ“§ Email Reports: Complete analysis sent directly to your email
  • πŸ”„ Unlimited Practice: Take multiple mock interviews to improve
  • πŸ“Š Progress Tracking: Monitor your improvement over time

πŸ‘¨πŸ« Mentorship Program

  • 🌟 Expert Mentors: Connect with professionals from Amazon, Google, Microsoft, Meta
  • πŸ“… 1-on-1 Sessions: Personalized career guidance and interview preparation
  • πŸ’‘ Industry Insights: Learn about latest trends and technologies
  • 🎯 Career Planning: Get roadmap for your dream job
  • πŸ“š Resource Sharing: Access exclusive learning materials

πŸ† Hackathons & Competitions

  • πŸ’» Coding Challenges: Participate in regular hackathons
  • πŸ… Prizes & Recognition: Win cash prizes and certificates
  • 🀝 Team Building: Collaborate with other developers
  • πŸš€ Project Showcase: Display your projects to potential employers
  • πŸ“ˆ Skill Development: Improve coding and problem-solving skills

πŸ’Ό Internship & Job Portal

  • πŸ” Job Search: Find internships and full-time positions
  • 🎯 Smart Matching: AI-powered job recommendations
  • πŸ“ Application Tracking: Monitor your application status
  • πŸ’Ό Company Profiles: Learn about top tech companies
  • πŸ“Š Salary Insights: Get market salary information

🏒 HR & Recruiter Features

πŸ›‘οΈ Advanced Interview System

  • πŸ‘οΈ Anti-Cheating Detection: Tab switch, copy-paste monitoring
  • πŸŽ₯ Screen Recording: Optional full-screen recording for verification
  • 🚨 Real-time Alerts: Visual indicators for suspicious activities
  • πŸ“ Activity Logging: Complete audit trail of candidate actions

πŸ“Š Comprehensive Dashboard

  • πŸ“ˆ Real-time Statistics: Live interview and candidate metrics
  • πŸ† Candidate Ranking: Automatic sorting by AI scores (highest first)
  • πŸ” Detailed Analytics: In-depth performance insights with AI feedback
  • πŸ’° Balance Management: Transparent pricing system
  • πŸ“§ Email Integration: Automated candidate invitations and reports

🎯 Smart Recruitment Tools

  • πŸ€– AI Candidate Screening: Automated initial screening process
  • πŸ“‹ Custom Question Banks: Create role-specific interview questions
  • πŸ“Š Performance Analytics: Track hiring success rates
  • πŸ”„ Interview Scheduling: Automated scheduling system
  • πŸ“ˆ Reporting Dashboard: Generate detailed hiring reports

🌟 Platform Benefits

πŸ‘¨πŸŽ“ For Students

  • Free Mock Interviews: Practice unlimited times at no cost
  • Expert Mentorship: Learn from industry professionals
  • Skill Development: Improve through hackathons and competitions
  • Job Opportunities: Access to exclusive internships and jobs
  • Career Growth: Comprehensive career development ecosystem
  • AI-Powered Feedback: Get detailed analysis of your performance

🏒 For Companies

  • Quality Candidates: Access pre-screened, skilled candidates
  • Efficient Hiring: Reduce time-to-hire with AI-powered screening
  • Cost Effective: Transparent pricing with measurable ROI
  • Anti-Cheating: Ensure interview integrity with advanced monitoring
  • Data-Driven: Make informed decisions with detailed analytics
  • Scalable Solution: Handle high-volume recruitment efficiently

πŸ› οΈ Technology Stack

πŸ”§ Backend Technologies

Technology Purpose Version
Node.js + Express RESTful API server 16.0+
MongoDB + Mongoose Database with intelligent schemas 4.4+
Google Gemini AI Advanced answer analysis Latest
JWT Authentication Secure token-based auth -
Nodemailer Email service integration -
Multer File upload handling -
Bcrypt Password encryption -
Cors Cross-origin resource sharing -

🎨 Frontend Technologies

Technology Purpose Version
React + Vite Modern frontend framework 18.0+
Tailwind CSS Utility-first styling 3.0+
React Router Client-side routing 6.0+
Context API State management -
Axios HTTP client -
React Icons Icon library -
React Hot Toast Notification system -

πŸš€ Installation & Setup

πŸ“‹ Prerequisites

Before you begin, ensure you have the following installed:

πŸ“ Project Structure

NeoRecruiter/
β”œβ”€β”€ Backend/          # Node.js + Express API
β”œβ”€β”€ Frontend/         # React + Vite Application
β”œβ”€β”€ README.md         # Project documentation
└── .gitignore        # Git ignore rules

πŸ”§ Backend Setup

  1. Navigate to Backend Directory

    cd Backend
  2. Install Dependencies

    npm install
  3. Environment Configuration Create a .env file in the Backend directory:

    PORT=4000
    MONGO_URI=mongodb://localhost:27017/neorecruiter
    JWT_SECRET=your-super-secret-jwt-key-here
    EMAIL_USER=[email protected]
    EMAIL_PASS=your-gmail-app-password
    GEMINI_API_KEY=your-gemini-api-key-here
  4. Start Development Server

    npm start

    Server will run on http://localhost:4000

🎨 Frontend Setup

  1. Navigate to Frontend Directory

    cd Frontend
  2. Install Dependencies

    npm install
  3. Environment Configuration Create a .env file in the Frontend directory:

    VITE_BASE_URL=http://localhost:4000
  4. Start Development Server

    npm run dev

    Application will run on http://localhost:5173

πŸ”‘ Getting API Keys

  1. Google Gemini API Key:

  2. Gmail App Password:

    • Enable 2-factor authentication on your Gmail
    • Generate an app-specific password
    • Use this password in the EMAIL_PASS field

🎯 Getting Started

πŸ‘¨πŸŽ“ For Students

  1. Visit neorecruiter.vercel.app
  2. Click "Student" and start your first mock interview
  3. Get AI-powered feedback and improve your skills
  4. Explore mentorship and internship opportunities
  5. Participate in hackathons and competitions

🏒 For HR/Recruiters

  1. Visit neorecruiter.vercel.app
  2. Click "HR" and create your recruiter account
  3. Set up your first interview campaign
  4. Invite candidates and start screening
  5. Access detailed analytics and reports

πŸš€ Deployment

The application is deployed using modern cloud services:

Service Platform URL
Frontend Vercel neorecruiter.vercel.app
Backend Render neorecruiter-ai-hr.onrender.com
Database MongoDB Atlas Cloud Database

πŸ“¦ Deployment Steps

Frontend (Vercel)

  1. Connect your GitHub repository to Vercel
  2. Set environment variables in Vercel dashboard
  3. Deploy automatically on every push to main branch

Backend (Render)

  1. Connect your GitHub repository to Render
  2. Configure environment variables
  3. Set build command: npm install
  4. Set start command: npm start

🀝 Contributing

We welcome contributions! Here's how you can help:

  1. 🍴 Fork the repository
  2. 🌿 Create a feature branch
    git checkout -b feature/amazing-feature
  3. πŸ’Ύ Commit your changes
    git commit -m 'Add some amazing feature'
  4. πŸ“€ Push to the branch
    git push origin feature/amazing-feature
  5. πŸ”„ Open a Pull Request

πŸ“‹ Contribution Guidelines

  • Follow the existing code style
  • Write clear commit messages
  • Add tests for new features
  • Update documentation as needed

🎯 Future Enhancements

πŸŽ“ Student Features

  • Mobile App: React Native app for on-the-go learning
  • AI Career Coach: Personalized career guidance chatbot
  • Skill Assessments: Technical skill evaluation tests
  • Virtual Career Fairs: Online networking events
  • Peer Learning: Study groups and collaboration tools

🏒 HR Features

  • Video Interview Support: Real-time video interviews
  • Advanced Analytics: Machine learning insights
  • Integration APIs: Third-party HR system integrations
  • Multi-language Support: Internationalization
  • Advanced Proctoring: Enhanced anti-cheating measures
  • Bulk Operations: Mass candidate management tools

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ“ž Contact & Support

πŸ‘¨πŸ’» Developer: Shivam Sharma

Email GitHub LinkedIn


πŸš€ Join thousands of students and companies using NeoRecruiter for smarter hiring! πŸš€

⭐ If you found this project helpful, please give it a star! ⭐

Made with ❀️ by Shivam Sharma

About

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published