{"id":26261889,"url":"https://github.com/coding-chemist/smarthire","last_synced_at":"2026-04-13T05:41:21.303Z","repository":{"id":282087397,"uuid":"947204826","full_name":"coding-chemist/SmartHire","owner":"coding-chemist","description":"An AI-powered resume screening system that analyzes candidate profiles, matches them with job criteria, and provides structured justifications. Automates hiring decisions with intelligent ranking and insights. 🚀🤖","archived":false,"fork":false,"pushed_at":"2025-03-12T18:32:15.000Z","size":14,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"rag","last_synced_at":"2025-03-12T18:40:53.318Z","etag":null,"topics":["groq","langchain","llm","mistral-saba-24b","mongodb","pydantic","pypdf2","python","rag"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/coding-chemist.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-12T10:15:26.000Z","updated_at":"2025-03-12T18:39:22.000Z","dependencies_parsed_at":"2025-03-12T18:50:59.557Z","dependency_job_id":null,"html_url":"https://github.com/coding-chemist/SmartHire","commit_stats":null,"previous_names":["coding-chemist/smarthire"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coding-chemist%2FSmartHire","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coding-chemist%2FSmartHire/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coding-chemist%2FSmartHire/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coding-chemist%2FSmartHire/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coding-chemist","download_url":"https://codeload.github.com/coding-chemist/SmartHire/tar.gz/refs/heads/rag","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243500787,"owners_count":20300775,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["groq","langchain","llm","mistral-saba-24b","mongodb","pydantic","pypdf2","python","rag"],"created_at":"2025-03-14T00:16:30.902Z","updated_at":"2025-12-30T05:56:11.077Z","avatar_url":"https://github.com/coding-chemist.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SmartHire  \nSmartHire is an AI-powered **resume screening and candidate ranking** system designed to streamline the hiring process. Using **LLM-powered justifications**, it analyzes resumes against job requirements and provides structured comparisons to help HR teams make data-driven hiring decisions.\n\n![SmartHire](UI.png)\n\n## Form\n![SmartHire](Form.png)\n\n## Candidate Comparison \nCandidature of Isabella Moore, Jack Anderson, Emma Wilson, David Lee are all AI Generated. \nAny resemblance to real persons, living or dead, is purely coincidental.\n\n![SmartHire](BestFit.png)\n\n![SmartHire](NextMatch.png)\n\n## 🚀 Tech Stack  \n\n- ![Streamlit](https://img.shields.io/badge/Streamlit-1.43.1-red?logo=streamlit)  \n- ![MongoDB](https://img.shields.io/badge/MongoDB-6.0-green?logo=mongodb)  \n- ![LangChain](https://img.shields.io/badge/LangChain-0.3.20-blue?logo=python)  \n- ![Groq](https://img.shields.io/badge/Groq-0.18.0-green?logo=python)  \n- ![Pydantic](https://img.shields.io/badge/Pydantic-2.7.0-orange?logo=python)  \n\n## ✨ Features  \n\n✅ **AI-Powered Resume Screening**: Compares resumes with job criteria and ranks candidates based on skills, experience, and education.  \n\n✅ **Structured LLM Justifications**: Uses **Groq’s Gemma 2-9B** to generate structured candidate evaluations, including **Education Match, Experience Match, Skill Fit, Role Fit, and SWOT Analysis**.  \n\n✅ **Candidate Comparison**: Displays top candidates side by side in **Streamlit columns** for easy evaluation.  \n\n✅ **Expander for Alternative Matches**: Shows the next-best candidates with justifications.  \n\n✅ **Resume Storage \u0026 Retrieval**: Uses **MongoDB** to store and retrieve structured resume data.  \n\n---\n\n## 📥 Installation  \n\nFollow these steps to set up **SmartHire**:\n\n### 1️⃣ Clone the repository  \n```bash\ngit clone https://github.com/your-username/SmartHire.git\ncd SmartHire\n```\n\n### 2️⃣ Set up a virtual environment\n```bash\nconda create --name smarthire-env python=3.13\nconda activate smarthire-env\n```\n\n### 3️⃣ Install dependencies\n```bash\npip install -r requirements.txt\n```\n\n### 4️⃣ Ensure the following dependencies are in requirements.txt\n```txt\n    streamlit==1.43.1\n    pymongo==4.6.3\n    langchain==0.3.20\n    langchain-groq==0.2.5\n    langchain-ollama==0.2.3\n    groq==0.18.0\n    pydantic==2.7.0\n    python-dotenv==1.0.1\n```\n\n## ⚙️ Prerequisites\n- Python 3.13 or higher\n- MongoDB (running locally or a cloud instance)\n- Required Python libraries (see requirements.txt)\n\n## ▶️ Running the App\n### 1️⃣ Start MongoDB (if running locally)\n```bash\nmongod --dbpath /path/to/mongodb/data\n```\n\nOn Mac, if you installed MongoDB via Homebrew, you can start it using:\n```bash\nbrew services start mongodb-community\n```\n\n### 2️⃣ Run the Streamlit app\n```bash\nstreamlit run app.py\n```\nThe app will be available at http://localhost:8501.\n\n## 🏆 Usage\n- 1️⃣ **Upload Resumes:** Upload candidate resumes (structured JSON format).\n- 2️⃣ **Fill HR Job Criteria:** Enter required skills, experience, and education.\n- 3️⃣ **AI-Powered Screening:** SmartHire ranks candidates based on the best match.\n- 4️⃣ **Review Justifications:** Compare candidates side by side with structured LLM-generated justifications.\n- 5️⃣ **Explore Alternative Matches:** View the next-best candidates under an expander section.\n\n## 🤝 Contributing\nContributions are welcome! To contribute:\n\n- Fork the repository.\n- Create a new feature branch (git checkout -b feature-name).\n- Commit your changes and push to your fork.\n- Submit a pull request.\n\n## 📜 License\nSmartHire is open-source software licensed under the **GNU General Public License v3.0 (GPL-3.0)**.  \n\nThis means:  \n- You are free to **use, modify, and distribute** the software.  \n- Any modifications or derivative works **must also be open-source** under the same GPL-3.0 license.  \n- For more details, see the full license text in the `LICENSE` file or visit [GNU GPL-3.0](https://www.gnu.org/licenses/gpl-3.0.en.html).  \n\n## 🙏 Acknowledgements\n- **Streamlit** for the app UI.\n- **LangChain + Groq** for LLM-driven resume screening.\n- **MongoDB** for candidate storage and retrieval.\n- **Pydantic** for structured data validation.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoding-chemist%2Fsmarthire","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoding-chemist%2Fsmarthire","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoding-chemist%2Fsmarthire/lists"}