README.md

metadata

title: Resume Analyzer Pro
emoji: 📄
colorFrom: blue
colorTo: purple
sdk: streamlit
sdk_version: 1.39.0
app_file: app.py
pinned: false
license: mit

📄 Resume Analyzer Pro (Cinematic Edition)

A powerful, AI-driven resume optimization tool featuring a unique Cinematic Live Transformation viewer. This application analyzes resumes against job descriptions, provides scoring and feedback, and then rewrites the resume in real-time with a futuristic text-reveal animation.

✨ Features

• AI Analysis: detailed breakdown of ATS scores, strengths, weaknesses, and missing keywords using Google Gemini.
• Cinematic Enhancement: Watch your resume be rewritten line-by-line in a sci-fi inspired "Live Transformation Viewer."
• Format Support: extracts text from PDF and DOCX files.
• Targeted Optimization: (Optional) Compare your resume against a specific Job Description.
• Instant Download: Export the enhanced version as a formatted .docx or plain .txt.

🚀 Setup & Deployment

1. Prerequisites

You need a Google Gemini API Key. Get one for free at Google AI Studio.

2. Hugging Face Spaces Setup

If you are deploying this to a Hugging Face Space:

1. Create a new Space (Select Streamlit as the SDK).
2. Upload app.py and requirements.txt.
3. Go to Settings > Variables and secrets.
4. Click New secret.
   • Name: GEMINI_API_KEY
   • Value: (Paste your Google Gemini API Key here)
5. The app will restart automatically with AI features enabled.

Note: If no API key is provided, the app runs in "Demo Mode" using dummy data.

3. Local Installation

To run this app on your own machine:

# Clone the repository
git clone [https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME](https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME)
cd YOUR_SPACE_NAME

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows use: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Set your API key (Linux/Mac)
export GEMINI_API_KEY="your_api_key_here"
# Or on Windows (PowerShell)
# $env:GEMINI_API_KEY="your_api_key_here"

# Run the app
streamlit run app.py

🛠️ Tech Stack
Frontend: Streamlit

AI Engine: Google Gemini (via google-generativeai)

Parsing: PyPDF2, python-docx, docx2txt

Visualization: Custom CSS & HTML animations

💡 Usage Guide
Upload: Drag and drop your resume (PDF or DOCX) into the sidebar.

Context: (Optional) Paste the job description you are applying for.

Analyze: Click "Analyze Resume" to get your score and actionable feedback.

Transform: Click "Enhance & Play Cinematic Transformation".

Watch: Enjoy the animated rewrite in the main panel.

Download: Scroll down to download the polished Word document.

Built with ❤️ using Streamlit and Google Gemini.