README.md

---
title: AI Resume Classifier & Analyzer
emoji: 🎯
colorFrom: blue
colorTo: indigo
sdk: streamlit
sdk_version: 1.56.0
app_file: app.py
pinned: false
---

# 🎯 AI Resume Classifier / Akıllı CV Sınıflandırıcı

This project is an **Artificial Intelligence-based Resume Classification System** developed to automate HR processes. It analyzes resume content (PDF/DOCX/Text) and predicts the most suitable department for the candidate using NLP and Machine Learning.

Bu proje, İK süreçlerini otomatize etmek için geliştirilmiş **Yapay Zeka tabanlı bir CV Sınıflandırma Sistemi**dir. CV içeriğini (PDF/DOCX/Metin) analiz eder ve NLP ile Makine Öğrenmesi kullanarak aday için en uygun departmanı tahmin eder.

## 🚀 Features / Özellikler
* **Multi-Format Support:** Process PDF, DOCX, and raw text.
* **OCR Awareness:** Detects scanned (image-based) PDFs and guides the user.
* **Smart Prediction:** Hybrid approach using Keyword Matching + Trained ML Model.
* **Bilingual Interface:** Support for both English and Turkish.
* **Visual Analytics:** Includes WordCloud visualization with custom masking.

* **Çoklu Format Desteği:** PDF, DOCX ve ham metin işleme.
* **OCR Farkındalığı:** Taranmış (resim bazlı) PDF'leri algılar ve kullanıcıyı yönlendirir.
* **Akıllı Tahmin:** Anahtar Kelime Eşleme + Eğitilmiş ML Modeli ile hibrit yaklaşım.
* **Çift Dilli Arayüz:** Hem İngilizce hem Türkçe desteği.
* **Görsel Analiz:** Özel maskeleme ile Kelime Bulutu (WordCloud) görselleştirmesi.

## 🛠️ Technical Stack / Teknik Altyapı
* **Language:** Python
* **Frontend:** Streamlit
* **ML/NLP:** Scikit-learn, Joblib, TextBlob, NLTK
* **File Parsing:** Pdfplumber, Mammoth
* **Visualization:** WordCloud, Matplotlib, Pillow

## 📂 Project Structure / Proje Yapısı
- `app.py`: Main application code.
- `best_model.pkl`: Trained Classification Model.
- `tfidf_vectorizer.pkl`: Text vectorization asset.
- `requirements.txt`: Necessary Python libraries.
- `bulut_resmi.png`: Mask image for WordCloud.

---