Update README.md

README.md

@@ -10,4 +10,44 @@ pinned: false
 license: mit
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🧠 Resume Screener Agent - AI-Powered Matching Tool
+
+This Space hosts a LangChain-powered Resume Screening Agent that matches resumes to job descriptions with structured, explainable scoring. Designed to run on CPU and lightweight models, it works perfectly within Hugging Face Spaces.
+
+---
+
+## 🚀 Features
+
+- ✅ Match resumes with job descriptions in seconds  
+- ✅ Score compatibility (0–100)  
+- ✅ Extract matched skills  
+- ✅ Explain decisions with structured JSON output  
+- ✅ Runs entirely on CPU (swap OpenAI with HuggingFacePipeline for full offline)
+
+---
+
+## 🛠️ How It Works
+
+1. Paste plain text **resume** and **job description**.
+2. Agent evaluates using an LLM prompt chain.
+3. Outputs:
+   - `MatchScore` (0–100)
+   - `KeySkills` (list)
+   - `Justification` (text)
+
+---
+
+## 💡 Built With
+
+- [LangChain](https://www.langchain.com/)
+- [Gradio](https://gradio.app/)
+- CPU-compatible LLMs (e.g., `flan-t5-base`, `oasst-sft-1-pythia`)
+
+---
+
+## 📦 Requirements
+
+```txt
+gradio
+langchain
+openai  # Optional, replace with transformers + HuggingFacePipeline