Streamlit Resume Matcher

Table of Contents

• Introduction
• Features
• Installation
• Architecture
• Deployment
• License

Introduction

A simple resume matcher app built using Streamlit and Angular. The app calculates the match percentage between a job description and a resume using cosine similarity.

After opening the app, press F12 to force the Angular app to load via an iframe. Let me know how to fix this issue.

Features

• Upload a job description and a resume
• Calculate the match percentage based on cosine similarity
• Display the results using Streamlit components

Installation

1. Clone the repository:

git clone https://github.com/WodenWang820118/streamlit-resume-matcher.git

2. Install the required dependencies:

pip install -r requirements.txt

3. Please add a .env file in the root directory with the following content:

ENVIRONMENT=development

4. Run the Streamlit app:

streamlit run lib/main.py

or

python -m streamlit run lib/main.py

Architecture

Personally, I don't like to count on Streamlit components for the frontend, so instead of building a custom component, I decided to embed an Angular app inside the Streamlit app. Angular is responsible for all the business logic and Streamlit handles the coming data and calculates the cosine similarity. Finally, the app uses the Streamlit components to display the results.

Please note there is an experimental feature called st.experimental_fragment, which might reinforce the data binding between the Angular app and the Streamlit app. The ideal scenario would be to use this feature to pass the data between the two apps. Use Angular to handle the business logic and UI. Let Streamlit only handle the Python code.

Deployment

I'm using Netlify to deploy the app, so for production usage, you'll need to deploy the frontend somewhere. Please see the lib/root_component/__init__.py for details.

License

This project is licensed under the MIT License.