imBesideYou / README.md
itsdvirani's picture
Update README.md
9c8d701 verified
metadata
title: ImBesideYou
emoji: 🏢
colorFrom: blue
colorTo: pink
sdk: streamlit
sdk_version: 1.38.0
app_file: app.py
pinned: false

Project Overview

This project provides a comprehensive tool for analyzing and comparing multiple candidates based on various data points extracted from their introduction videos. It uses emotion scores, transcript scores, and the actual transcript text to generate insights about each candidate's communication skills, emotional expressions, and overall suitability for recruitment.

Features

  • Multi-candidate comparison
  • Analysis of emotion data
  • Evaluation of transcript scores
  • Gaze data analysis
  • Overall comparison across all data types
  • Interactive visualizations
  • AI-powered insights generation

How to Use

  1. Clone this repository to your local machine.
  2. Install the required dependencies:
    pip install -r requirements.txt
    
  3. Run the Streamlit app:
    streamlit run app.py
    
  4. Upload the required CSV and TXT files for each candidate when prompted.
  5. Select the type of analysis you want to perform.
  6. Use the chat interface to ask questions about the candidates and receive AI-generated insights.

Interface Usage Guide

  1. Uploading Data: Upload the required files for each candidate when prompted.

  2. Selecting Candidates: If you've uploaded data for multiple candidates, you can select which ones to include in your analysis using the multiselect dropdown.

  3. Choosing Analysis Type: Select the type of analysis you want to perform from the dropdown menu.

  4. Formulating Queries: Use the chat input to ask questions about the candidates. Here are some guidelines for effective queries:

    • For visualizations, include words like "compare", "graph", or "show" in your query.
    • To analyze specific features, mention them by name (e.g., "happy" for emotion, "speech_speed" for transcript score).
    • Available parameters for each analysis type are always shown on the screen.
    • To compare all features, use queries like "Please compare all emotions of the selected candidates" or "Show all transcript scores for the candidates".
    • For an overall comparison of candidates, choose the "overall comparison" option from the analysis type dropdown.
    • If you've uploaded data for 10 candidates but only want to compare 5, select those 5 from the multiselect dropdown before asking your query.

Examples:

  • "Graph the 'happy' emotion for all selected candidates"
  • "Compare the speech speed and confidence scores of Candidate 1 and Candidate 3"
  • "Show the distribution of all emotions for the selected candidates"
  • "Analyze the gaze patterns of all candidates"

Remember, the more specific your query, the more targeted the analysis will be!

File Structure

  • app.py: Main application file
  • emotion.py: Functions for emotion data analysis
  • transcrip_score.py: Functions for transcript score analysis
  • gaze.py: Functions for gaze data analysis
  • transcrip.py: Functions for transcript text analysis

Data Requirements

For each candidate, you need to provide:

  • emotion.csv: Contains emotion scores throughout the video
  • transcript_score.csv: Contains scores extracted from the transcript
  • gaze.csv: Contains gaze data from the video
  • transcript.txt: Contains the full transcript text

Dependencies

  • streamlit
  • pandas
  • seaborn
  • matplotlib
  • google-generativeai
  • numpy

Note on API Key

This project uses the Gemini API. Make sure to replace the placeholder API key in the code with your actual Gemini API key before running the application.

Contributing

Contributions to improve the project are welcome. Please fork the repository and create a pull request with your changes.