pascalx/careerplus
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
CareerPulse AI - Smart Resume Assistant
CareerPulse AI is an advanced AI-powered web application that helps job seekers optimize their resumes, identify skill gaps, and prepare for interviews - all tailored to specific job descriptions and companies.
Features
- Resume Polishing: Get AI-powered suggestions to highlight relevant skills and remove distractions from your resume.
- Skill Gap Analysis: Identify missing skills for your target role and get advice on how to present your existing experience.
- Interview Preparation: Generate likely interview questions based on the job description and industry standards.
- Company Research: Automatically research companies to provide customized advice that aligns with their culture and values.
- Job Sentiment Analysis: Analyze job descriptions for tone and potential red flags to give you the full picture.
- PDF Download: Export your analysis results as a PDF for future reference.
Technology Stack
- Backend: Python with Flask
- AI: Google's Gemini AI (via google-generativeai SDK)
- Frontend: HTML, CSS, JavaScript
- Styling: Tailwind CSS
- Search API: Tavily API for web searches
- PDF Processing: PyPDF2 for extracting text from resumes
Prerequisites
- Python 3.8 or higher
- Google Gemini API key
- Tavily API key (for web search functionality)
Installation
- Clone the repository:
git clone https://github.com/yourusername/careerpulse-ai.git
cd careerpulse-ai- 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 up your environment variables by creating a
.envfile:
GOOGLE_API_KEY="your_gemini_api_key_here"
TAVILY_API_KEY="your_tavily_api_key_here"Running the Application
- Start the Flask server:
python app.py- Open your browser and navigate to:
http://localhost:5001Using CareerPulse AI
- Upload Your Resume: Submit your current resume in PDF format.
- Enter Job Details: Paste the job description and specify the job title, company name, and industry.
- Optional LinkedIn URL: For more comprehensive analysis, include your LinkedIn profile URL.
- Get AI Analysis: Click "Start AI Analysis" to submit your information.
- Review Results: Explore the analysis divided into tabs for resume suggestions, skill gaps, interview questions, and overall feedback.
- Export Results: Download the analysis as a PDF for future reference.
Configuration Options
Gemini API
The application uses Google's Gemini API for AI analysis. You can configure different Gemini models by modifying the model_name variable in app.py.
Search Tool Options
The Tavily search API is used for web searches. You can adjust search settings by modifying the search_depth and max_results parameters in the perform_web_search function.
Project Structure
careerpulse-ai/
├── app.py # Main Flask application
├── requirements.txt # Python dependencies
├── .env # Environment variables (API keys)
├── .gitignore # Files/folders to ignore in Git
├── README.md # Project documentation
├── templates/
│ └── index.html # Main HTML page
└── static/
├── css/
│ └── style.css # Custom CSS styles
└── js/
└── script.js # Frontend JavaScriptContributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the MIT License - see the LICENSE file for details.
