Spaces:
Runtime error
Runtime error
| title: Job Application Optimizer | |
| emoji: 💼 | |
| colorFrom: purple | |
| colorTo: blue | |
| sdk: gradio | |
| sdk_version: "4.44.1" | |
| app_file: app.py | |
| pinned: false | |
| # Job Application Optimizer 💼 | |
| AI-powered tool to tailor your resume and generate personalized messages for job applications. | |
| ## 🌟 Features | |
| - **📄 Resume Analysis**: Upload your PDF resume and extract text | |
| - **🎯 Job Matching**: Paste any job description | |
| - **✨ AI-Powered Generation**: | |
| - 💬 LinkedIn message for recruiter (short, personal, 3-4 sentences) | |
| - 📧 Email to hiring manager (detailed, professional, 5-7 paragraphs) | |
| - 📑 Tailored resume content (ATS-optimized keywords) | |
| - ⬇️ Download as PDF | |
| ## 🤖 Supported Models | |
| - **GPT-4o** (OpenAI) - Premium, fastest, most accurate | |
| - **Claude-3.5-Sonnet** (Anthropic) - Premium, excellent for professional writing | |
| ## 🚀 Quick Start | |
| ### Local Development | |
| ```bash | |
| # 1. Install dependencies | |
| pip install -r requirements.txt | |
| # 2. Set up environment variables | |
| # Create a .env file with: | |
| OPENAI_API_KEY=your_openai_api_key_here | |
| ANTHROPIC_API_KEY=your_anthropic_api_key_here | |
| APP_PASSWORD=your_secure_password | |
| # 3. Run the app | |
| python app.py | |
| ``` | |
| The app will launch at `http://0.0.0.0:7860` with password protection. | |
| ### 🔐 Authentication | |
| - **Username**: `user` | |
| - **Password**: Set via `APP_PASSWORD` environment variable (default: `jobapp123`) | |
| ## 📦 Deployment to HuggingFace Spaces | |
| ### Step 1: Create a Space | |
| 1. Go to [HuggingFace Spaces](https://huggingface.co/spaces) | |
| 2. Click **"Create new Space"** | |
| 3. Choose: | |
| - **Name**: `job-application-optimizer` (or your preferred name) | |
| - **SDK**: Gradio | |
| - **Hardware**: CPU Basic (free tier works fine) | |
| - **Visibility**: Public or Private | |
| ### Step 2: Upload Files | |
| Upload these files to your Space: | |
| ``` | |
| ├── app.py | |
| ├── requirements.txt | |
| ├── packages.txt | |
| └── README.md | |
| ``` | |
| ### Step 3: Configure Secrets | |
| Go to **Settings → Repository secrets** and add: | |
| ``` | |
| OPENAI_API_KEY=sk-...your-key-here | |
| ANTHROPIC_API_KEY=sk-ant-...your-key-here | |
| APP_PASSWORD=your-secure-password | |
| ``` | |
| ### Step 4: Deploy! 🎉 | |
| Your app will automatically build and deploy. Access it at: | |
| ``` | |
| https://huggingface.co/spaces/YOUR_USERNAME/job-application-optimizer | |
| ``` | |
| ## 📖 How to Use | |
| 1. **Login** with the password you set | |
| 2. **Upload** your resume PDF (any format accepted) | |
| 3. **Paste** the complete job description | |
| 4. **Select** your preferred AI model (GPT-4o or Claude) | |
| 5. **Click** "Generate Application Materials" | |
| 6. **Review** the generated content: | |
| - Copy LinkedIn message | |
| - Copy email content | |
| - Review tailored resume | |
| 7. **Download** the tailored resume as PDF | |
| ## ⚠️ Ethical Use Notice | |
| **This tool ONLY optimizes existing resume content. It NEVER fabricates experience.** | |
| What it does: | |
| - ✅ Rewrites bullet points for clarity and impact | |
| - ✅ Adjusts keywords to match job requirements | |
| - ✅ Reorders/emphasizes relevant experience | |
| - ✅ Highlights transferable skills | |
| What it NEVER does: | |
| - ❌ Add skills or experience not in original resume | |
| - ❌ Change dates, company names, or job titles | |
| - ❌ Fabricate education or certifications | |
| - ❌ Invent projects or achievements | |
| **All outputs remain truthful to your original resume.** | |
| ## 🔧 Troubleshooting | |
| ### "Error: OPENAI_API_KEY not found" | |
| - Make sure you added the API key in Space secrets | |
| - Restart the Space after adding secrets | |
| ### "Error reading PDF" | |
| - Ensure your PDF is not password-protected | |
| - Try re-saving the PDF and uploading again | |
| ### "No response from AI" | |
| - Check your API key has credits/quota | |
| - Try switching to the other model | |
| ### PDF Download Not Working | |
| - Make sure you generated content first | |
| - The tailored resume text must be present | |
| ## 📝 Requirements | |
| - Python 3.9+ | |
| - Gradio 4.44.1 | |
| - OpenAI API key (for GPT-4o) | |
| - Anthropic API key (for Claude) | |
| See `requirements.txt` for full dependencies. | |
| ## 🤝 Support | |
| For issues or questions: | |
| 1. Check the troubleshooting section above | |
| 2. Verify your API keys are valid and have credits | |
| 3. Ensure your resume PDF is readable | |
| ## 📄 License | |
| This project is provided as-is for educational and personal use. | |
| --- | |
| **Made with ❤️ for job seekers everywhere** | |