Skip to content

AI-powered hiring platform for fair, efficient, and transparent recruitment using resume parsing, video integrity, and emotion analytics

Notifications You must be signed in to change notification settings

zennyMe17/ethicra

Repository files navigation

Ethicra

Ethicra is an innovative, AI-powered job hiring platform engineered to make recruitment fair, efficient, and transparent for both job seekers and hiring organizations. By leveraging modern web technology and cloud services, Ethicra tackles common hiring challengesโ€”including resume exaggeration, biased selection, and lengthy interview cyclesโ€”head-on.

Developed by Hemanth S and Team CodeMonks, Department of Computer Science and Cybersecurity Engineering, Ramaiah Institute of Technology


๐ŸŒ Live Deployments


๐Ÿš€ Features at a Glance

โœ… Seamless User Experience

  • Modern, mobile-friendly UI (Next.js + Tailwind CSS)
  • Responsive dashboards for both applicants and admins
  • Enabled user profile customization for personalized assessments, increasing user retention by 60%.

๐Ÿ” User Authentication & Security

  • Firebase Authentication for secure logins
  • Multiple sign-in options: Email, Passwordless, Google, GitHub
  • Session management for both users and admins

๐Ÿ“ Resume & Profile Management

  • Easy resume uploads (PDF/Image)
  • Secure storage: Resumes uploaded to AWS S3
  • Resume text extraction: OCR.space API for parsing
  • Centralized user data: Profiles & resume links stored in Firebase

๐Ÿ’ผ Job Application Workflow

  • Organizations/admins: Post new job openings in seconds
  • Applicants: Browse, search, and apply to jobs online
  • Live Application Statuses: Instantly see your progress for each job
  • Admin tools: Review applicants, shortlist, and manage interviews

๐Ÿค– AI-Driven Interview Experience

  • Resume-based question generation: Handled by Vapi, which integrates LLM (OpenAI) for dynamic, personalized interview questions
  • Voice-first: Speech-to-text & text-to-speech for natural conversations
  • Video integrity: Live face-detection and recording for authenticity (Render deployment only)

๐Ÿ“Š Automated Reporting & Analytics

  • Automated report generation: After each interview
  • Video frame analytics: Tracks all detected faces and key events
  • Emotion analysis: Frame-by-frame emotion summary (happy, sad, neutral, etc.)
  • Scoring: AI-evaluated transcripts with objective scoring

๐Ÿ—๏ธ Technology Stack

Layer Technology Purpose
Frontend Next.js, Tailwind CSS Modern, fast UI
Authentication Firebase Auth Secure, multi-provider login
Database Firebase Firestore Real-time user & job data
File Storage AWS S3 Resume & media uploads
Resume Extraction OCR.space API Parse resumes (PDF/Image)
AI/Interview OpenAI, VAPI LLM Q&A, speech, evaluation
Video/Integrity TensorFlow.js, BlazeFace Live face detection

โ˜๏ธ SaaS Platform Design

  • Designed and deployed a scalable SaaS web application delivering AI-powered mock interviews for job aspirants.
  • Cloud-first architecture: Ethicra is built to scaleโ€”supporting thousands of concurrent users, hiring teams, and interview sessions.

โ“ FAQ (Frequently Asked Questions)

1. What is Ethicra?

Ethicra is an AI-powered job hiring platform designed to make recruitment fair, efficient, and transparent for both job seekers and hiring organizations. It leverages modern web technology and AI services to tackle challenges like resume exaggeration, biased selection, and lengthy interview processes.

2. How is Ethicra different from other job portals?

Ethicra uniquely combines AI-driven resume parsing, automated interview questions, live video integrity checks, and emotion analytics to ensure unbiased and authentic assessments for candidates. It also provides real-time dashboards and automated reporting for both applicants and admins.

3. Is my data safe on Ethicra?

Yes! Ethicra uses Firebase Authentication for secure login, AWS S3 for encrypted file storage, and follows best practices for user privacy and data security.

4. What file types are supported for resume uploads?

You can upload your resume in PDF or image formats (such as PNG, JPG).

5. How does the AI interview work?

If youโ€™re shortlisted, the platform generates personalized interview questions based on your resume. Youโ€™ll interact with an AI bot through voice, and your video is recorded with live face detection for integrity (on certain deployments). Afterward, you receive an automated report with analytics and scoring.

6. Which features require video and face detection?

Video interview integrity and face detection are available on the main Render deployment (https://ethicra.onrender.com/). The Vercel demo does not include video integrity features.

7. What happens after I complete an interview?

Youโ€™ll receive a detailed report including video analytics, emotion summary, AI-generated transcript, and scoring. Admins use these unbiased reports for final selection.

8. Who can post jobs on Ethicra?

Only verified organizations and admins can post, edit, or close job listings. Applicants can browse and apply to all open jobs.

9. Can I practice interviews without applying for jobs?

Yes! The User Dashboard offers a practice interview mode so you can hone your skills in a no-risk environment.

10. How do I contribute to Ethicra?

Simply open an issue or submit a pull request with your feature, bug fix, or suggestion. All contributions are welcome!


Still have questions? Feel free to open an issue or reach out via the project repository!

๐Ÿ Getting Started

Prerequisites

  • Node.js
  • Firebase project + config
  • AWS S3 bucket & credentials

Installation

git clone https://github.com/zennyMe17/ethicra.git
cd ethicra
npm install
# or
yarn install
  1. Configure Firebase:

    • Set up your Firebase project (Auth + Firestore)
    • Add your Firebase config to .env or your config file
  2. Configure AWS S3:

    • Add your AWS credentials and S3 bucket info to environment variables
  3. Start the server:

    npm run dev

    Visit http://localhost:3000 in your browser!


๐Ÿ—‚๏ธ Project Structure

  • app/ โ€” Main Next.js app pages (user/admin dashboards, interview, resume scanner, etc.)
  • components/ โ€” Reusable UI elements & interview widgets
  • firebase/ โ€” Firebase config and custom hooks
  • utils/ โ€” Helper functions (e.g., AWS upload)
  • styles/ โ€” Tailwind CSS & custom styling

๐Ÿง‘โ€๐Ÿ’ผ User Journey

1. Register/Login

  • Sign up easily with email or OAuth (Google/GitHub)
  • Your session is secure and persists across sessions

2. Create/Update Profile

  • Add your details and upload your resume (PDF/Image)
  • Resume is parsed and securely stored

3. Browse & Apply for Jobs

  • Explore all open jobs posted by organizations/admins
  • Apply with one click (resume required)
  • Track your application status in real time

4. AI-Powered Interview (if shortlisted)

  • If selected, launch a resume-driven AI interview
  • Interview bot asks tailored questions about your skills & projects
  • Audio-based Q&A, plus live video recording & face detection for integrity (Render deployment only)
  • See: app/interview/VapiInterviewBotClient.tsx
  • See: components/InterviewRecordingAndFaceDetection.tsx

5. Automated Report & Feedback

  • After the interview:
    • Video analytics on face presence and behavior
    • Emotion summary (e.g., happy, sad, neutral) frame-by-frame
    • Transcript generation & AI-based scoring
    • See: components/InterviewReportsDialog.tsx
  • Admins review your reports, transcripts, and scores for unbiased selection

๐Ÿ›ก๏ธ Admin Dashboard

  • Full job management: Post, edit, close jobs
  • Applicant tracking: See all applicants, resumes, statuses, and reports
  • Interview controls: Select candidates, trigger interviews, review evaluations
  • Security: Only authenticated admins can access
  • See: app/admin/dashboard/page.tsx

๐Ÿ  User Dashboard

  • Profile & Resume: Quickly view and update your resume/profile
  • Practice Interviews: Hone your skills in a safe environment (no stakes)
  • My Applications: Instantly see which jobs youโ€™ve applied for, and next steps
  • Live Statuses: Visual badges & progress for each job (applied, shortlisted, interviewed, etc.)
  • Resume-based Interview Launch: Start your official interview if selected
  • Protected: Only logged-in users can access
  • See: app/dashboard/page.tsx

๐Ÿ—บ๏ธ Roadmap

  • Enhanced analytics for users and admins
  • Notification system (email, in-app)
  • More AI-driven bias detection
  • Organization analytics dashboard
  • ...and much more!

๐Ÿค Contributing

We welcome contributions!
Open an issue or submit a pull request for new features, bug fixes, or suggestions.


Ethicra is constantly evolving. Stay tuned for more updates and features!

About

AI-powered hiring platform for fair, efficient, and transparent recruitment using resume parsing, video integrity, and emotion analytics

Topics

Resources

Stars

Watchers

Forks