momalmir/smart-resume-optimizer

<!-- HF README START -->

🧠 Smart Resume Optimizer

Smart Resume Optimizer helps job seekers generate tailored, optimized resumes and cover letters based on job descriptions using LLMs via OpenRouter. It supports models like Claude 3, GPT-4, Mistral, DeepSeek, and more.


[image]

📚 Table of Contents

• —🧠 Smart Resume Optimizer
• —✨ How It Works
• —🔐 Privacy Notice
• —🧾 Requirements
• —⚙️ Developer Setup
• —🔁 Run Locally with Docker
• —🧪 Manual Setup (No Docker)
• —🌍 Environment Variables
• —🧪 Testing (Optional)
• —🚀 Deployment
• —🙋‍♂️ Author

✨ How It Works

1. 1.Upload your PDF file or LaTeX file of resume
2. 2.Paste the job description you're targeting
3. 3.Enter an optional custom prompt with instructions for tailoring (there are two default prompts for PDF and LaTeX input the app will use if you do not provide any)
4. 4.Choose an LLM model
5. 5.Click Optimize Resume
6. 6.View and download your tailored resume as a PDF
7. 7.Extract comma-separated skills from the tailored resume
8. 8.Generate a personalized cover letter tailored to the same job

You can change the font and layout of the resume and cover letter by editing their respective LaTeX template files in backend/custom_resume_template.tex and backend/custom_cover_template.tex.

The system supports any model on OpenRouter, including:

• —anthropic/claude-3.7-sonnet
• —gpt-4-turbo
• —deepseek/deepseek-chat
• —...and more

For skill extraction, it is recommended to use a lightweight model such as moonshotai/kimi-k2 for faster performance and lower cost. The same model selected for resume generation is used for the cover letter.

🔐 Privacy Notice

This application runs entirely in your browser and does not store or send your resume or job description to any third party except to the selected LLM model via the OpenRouter API (under your API key). We do not log or collect:

• —Your OpenRouter API key
• —Your uploaded resume
• —The job description or tailored output

🧾 Requirements

To use the hosted app, you’ll need:

• —📄 A resume in PDF or LaTeX format
• —📋 A job description you're applying to
• —✍️ A custom prompt describing how to tailor the resume
• —🔑 An OpenRouter API key (sign up at openrouter.ai)

<!-- HF README END -->

<!-- GITHUB DEV DOCS START -->

⚙️ Developer Setup

You can clone and run the app locally or build your own Docker container.

🔁 Run Locally with Docker

docker build -t smart-resume .
docker run -p 7860:7860 smart-resume

Visit http://localhost:7860 after the container starts.

🧪 Manual Setup (No Docker)

git clone https://github.com/msmalmir/Smart-Resume-Optimizer.git
cd Smart-Resume-Optimizer
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
streamlit run app.py

🌍 Environment Variables

Create a .env file in the root or export directly in your terminal:

OPENROUTER_API_KEY=your-api-key-here

🚀 Deployment

This app is deployed automatically to Hugging Face Spaces via GitHub Actions.

To deploy:

• —Push to main, or
• —Trigger the Deploy action manually from the GitHub Actions tab

🙋‍♂️ Author

📧 Email: ms.malmir@gmail.com 🔗 GitHub: github.com/momalmir 🔗 LinkedIn: https://www.linkedin.com/in/mostafa-malmir/

<!-- GITHUB DEV DOCS END -->