Create app.py

app.py

@@ -0,0 +1,340 @@
+# ⚡ Quick Start Guide
+
+Get the AI Graduate Job-Matching Platform running in 5 minutes!
+
+## 🎯 Prerequisites
+
+- Python 3.8+ installed
+- Groq API key ([Get one here](https://console.groq.com/))
+- 2GB free disk space
+- Internet connection
+
+## 🚀 Option 1: Automated Setup (Recommended)
+
+### For Linux/Mac:
+
+```bash
+# 1. Clone or download the project
+git clone <repository-url>
+cd ai-job-matcher
+
+# 2. Make setup script executable
+chmod +x setup.sh
+
+# 3. Run setup
+./setup.sh
+
+# 4. Edit .env file with your API key
+nano .env  # or use your favorite editor
+
+# 5. Run the application
+python app.py
+```
+
+### For Windows:
+
+```powershell
+# 1. Clone or download the project
+git clone <repository-url>
+cd ai-job-matcher
+
+# 2. Create virtual environment
+python -m venv venv
+
+# 3. Activate virtual environment
+.\venv\Scripts\activate
+
+# 4. Install dependencies
+pip install -r requirements.txt
+
+# 5. Create .env file
+echo GROQ_API_KEY=your_key_here > .env
+
+# 6. Run the application
+python app.py
+```
+
+## 🛠️ Option 2: Manual Setup
+
+### Step 1: Install Dependencies
+
+```bash
+pip install groq==0.11.0 gradio==4.44.0 moviepy==1.0.3
+```
+
+### Step 2: Set Environment Variable
+
+**Linux/Mac:**
+```bash
+export GROQ_API_KEY="your_groq_api_key_here"
+```
+
+**Windows:**
+```powershell
+$env:GROQ_API_KEY="your_groq_api_key_here"
+```
+
+### Step 3: Create File Structure
+
+```
+ai-job-matcher/
+├── app.py
+├── requirements.txt
+├── utils/
+│   ├── __init__.py
+│   ├── transcription.py
+│   ├── analysis.py
+│   └── job_match.py
+└── ui/
+    ├── __init__.py
+    └── layout.py
+```
+
+### Step 4: Run Application
+
+```bash
+python app.py
+```
+
+### Step 5: Open Browser
+
+Navigate to: `http://localhost:7860`
+
+## 🎬 First Test
+
+### 1. Record a Test Video (1-2 minutes)
+
+Sample script:
+```
+"Hello, my name is [Your Name]. I recently graduated with a degree in [Your Field].
+I have skills in [Skill 1], [Skill 2], and [Skill 3]. I'm passionate about [Interest]
+and looking to start my career in [Industry]. Thank you!"
+```
+
+### 2. Upload Video
+
+- Click the upload box
+- Select your video file
+- Choose language (English or Urdu)
+
+### 3. Generate Report
+
+- Click "Generate Job Match Report"
+- Wait 30-60 seconds
+- Review results in different tabs
+
+## 📱 Access from Mobile
+
+1. Find your local IP:
+   ```bash
+   # Linux/Mac
+   ifconfig | grep inet
+   
+   # Windows
+   ipconfig
+   ```
+
+2. Share the app:
+   ```python
+   # In app.py, change:
+   demo.launch(share=True)
+   ```
+
+3. Use the generated public URL
+
+## 🐛 Troubleshooting
+
+### "GROQ_API_KEY not found"
+
+**Solution:**
+```bash
+# Check if key is set
+echo $GROQ_API_KEY  # Linux/Mac
+echo %GROQ_API_KEY%  # Windows
+
+# Set it again
+export GROQ_API_KEY="your_key"  # Linux/Mac
+set GROQ_API_KEY=your_key  # Windows
+```
+
+### "Module not found"
+
+**Solution:**
+```bash
+# Reinstall requirements
+pip install -r requirements.txt --force-reinstall
+```
+
+### "Port 7860 already in use"
+
+**Solution:**
+```python
+# In app.py, change port:
+demo.launch(server_port=7861)
+```
+
+### Video upload fails
+
+**Solution:**
+- Check video format (MP4, WebM, MOV)
+- Check file size (< 100MB)
+- Check duration (< 2 minutes)
+
+## ☁️ Deploy to Hugging Face (5 minutes)
+
+### Quick Deploy:
+
+1. **Create Space:**
+   - Go to [HF Spaces](https://huggingface.co/spaces)
+   - Click "Create new Space"
+   - Choose Gradio SDK
+
+2. **Upload Files:**
+   ```bash
+   git clone https://huggingface.co/spaces/USERNAME/SPACE_NAME
+   cd SPACE_NAME
+   cp -r /path/to/your/project/* .
+   git add .
+   git commit -m "Initial commit"
+   git push
+   ```
+
+3. **Add Secret:**
+   - Go to Space Settings
+   - Add secret: `GROQ_API_KEY`
+
+4. **Access:**
+   - URL: `https://huggingface.co/spaces/USERNAME/SPACE_NAME`
+
+## 📊 What to Expect
+
+### Processing Time:
+- Upload: < 5 seconds
+- Transcription: 10-20 seconds
+- Analysis: 15-25 seconds
+- Total: 30-60 seconds
+
+### Output Quality:
+- Transcription accuracy: > 95%
+- Job matches: 10 recommendations
+- Report length: 2000+ words
+
+## 🎓 Example Use Cases
+
+### Computer Science Graduate:
+```
+Skills: Python, JavaScript, React
+Expected Jobs: Software Developer, Web Developer, Full-Stack Engineer
+Match Scores: 75-90%
+```
+
+### Business Graduate:
+```
+Skills: Marketing, Excel, Communication
+Expected Jobs: Marketing Coordinator, Business Analyst, Sales Associate
+Match Scores: 70-85%
+```
+
+### Engineering Graduate:
+```
+Skills: CAD, Project Management, Problem-solving
+Expected Jobs: Project Engineer, Design Engineer, Technical Coordinator
+Match Scores: 72-88%
+```
+
+## 📚 Next Steps
+
+1. **Read Full Documentation:**
+   - `README.md` - Complete guide
+   - `DEPLOYMENT.md` - Deploy to production
+   - `TESTING.md` - Testing strategies
+
+2. **Customize:**
+   - Modify UI colors/layout
+   - Add your company logo
+   - Adjust scoring weights
+
+3. **Extend:**
+   - Add PDF generation
+   - Integrate with job boards
+   - Add authentication
+
+## 💡 Pro Tips
+
+### Tip 1: Better Videos = Better Results
+- Use good lighting
+- Speak clearly
+- Minimize background noise
+- Stay under 2 minutes
+
+### Tip 2: Test with Various Profiles
+- IT/Tech graduates
+- Business graduates
+- Engineering graduates
+- Different experience levels
+
+### Tip 3: Monitor Performance
+```python
+import time
+
+start = time.time()
+result = process_video(video, language)
+print(f"Processing took {time.time() - start:.2f} seconds")
+```
+
+### Tip 4: Customize Job Weights
+```python
+# In utils/job_match.py
+SCORING_WEIGHTS = {
+    "technical_skills": 0.35,  # Increase technical importance
+    "soft_skills": 0.20,
+    "communication_clarity": 0.15,
+    "personality_fit": 0.10,
+    "domain_relevance": 0.20
+}
+```
+
+## 🔥 Common Commands
+
+```bash
+# Start application
+python app.py
+
+# Run tests
+pytest tests/
+
+# Check code style
+pylint utils/ ui/
+
+# Generate coverage report
+pytest --cov=. --cov-report=html
+
+# Update dependencies
+pip install -r requirements.txt --upgrade
+
+# Create production build
+pip freeze > requirements.txt
+
+# Clean cache
+find . -type d -name "__pycache__" -exec rm -r {} +
+```
+
+## 📞 Get Help
+
+- 📖 Documentation: See `README.md`
+- 🐛 Issues: [GitHub Issues](link)
+- 💬 Discussion: [GitHub Discussions](link)
+- 📧 Email: support@example.com
+
+## ✅ Success Checklist
+
+- [ ] Python 3.8+ installed
+- [ ] Dependencies installed
+- [ ] GROQ_API_KEY configured
+- [ ] Application starts without errors
+- [ ] Test video processed successfully
+- [ ] All outputs display correctly
+- [ ] Both languages work
+- [ ] Ready for deployment!
+
+---