pascalx/careerplus

1---2title: Careerplus3emoji: 📊4colorFrom: pink5colorTo: yellow6sdk: docker7pinned: false8license: mit9short_description: AI powered resume analyser and editor10---11 12Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference13 14# CareerPulse AI - Smart Resume Assistant15 16CareerPulse 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.17 18![CareerPulse AI Screenshot](https://via.placeholder.com/800x400?text=CareerPulse+AI+Screenshot)19 20## Features21 22- **Resume Polishing**: Get AI-powered suggestions to highlight relevant skills and remove distractions from your resume.23- **Skill Gap Analysis**: Identify missing skills for your target role and get advice on how to present your existing experience.24- **Interview Preparation**: Generate likely interview questions based on the job description and industry standards.25- **Company Research**: Automatically research companies to provide customized advice that aligns with their culture and values.26- **Job Sentiment Analysis**: Analyze job descriptions for tone and potential red flags to give you the full picture.27- **PDF Download**: Export your analysis results as a PDF for future reference.28 29## Technology Stack30 31- **Backend**: Python with Flask32- **AI**: Google's Gemini AI (via google-generativeai SDK)33- **Frontend**: HTML, CSS, JavaScript34- **Styling**: Tailwind CSS35- **Search API**: Tavily API for web searches36- **PDF Processing**: PyPDF2 for extracting text from resumes37 38## Prerequisites39 40- Python 3.8 or higher41- Google Gemini API key42- Tavily API key (for web search functionality)43 44## Installation45 461. Clone the repository:47   ```48   git clone https://github.com/yourusername/careerpulse-ai.git49   cd careerpulse-ai50   ```51 522. Create a virtual environment:53   ```54   python -m venv venv55   source venv/bin/activate  # On Windows, use: venv\Scripts\activate56   ```57 583. Install dependencies:59   ```60   pip install -r requirements.txt61   ```62 634. Set up your environment variables by creating a `.env` file:64   ```65   GOOGLE_API_KEY="your_gemini_api_key_here"66   TAVILY_API_KEY="your_tavily_api_key_here"67   ```68 69## Running the Application70 711. Start the Flask server:72   ```73   python app.py74   ```75 762. Open your browser and navigate to:77   ```78   http://localhost:500179   ```80 81## Using CareerPulse AI82 831. **Upload Your Resume**: Submit your current resume in PDF format.842. **Enter Job Details**: Paste the job description and specify the job title, company name, and industry.853. **Optional LinkedIn URL**: For more comprehensive analysis, include your LinkedIn profile URL.864. **Get AI Analysis**: Click "Start AI Analysis" to submit your information.875. **Review Results**: Explore the analysis divided into tabs for resume suggestions, skill gaps, interview questions, and overall feedback.886. **Export Results**: Download the analysis as a PDF for future reference.89 90## Configuration Options91 92### Gemini API93 94The application uses Google's Gemini API for AI analysis. You can configure different Gemini models by modifying the `model_name` variable in `app.py`.95 96### Search Tool Options97 98The 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.99 100## Project Structure101 102```103careerpulse-ai/104├── app.py                  # Main Flask application105├── requirements.txt        # Python dependencies106├── .env                    # Environment variables (API keys)107├── .gitignore              # Files/folders to ignore in Git108├── README.md               # Project documentation109├── templates/110│   └── index.html          # Main HTML page111└── static/112    ├── css/113    │   └── style.css       # Custom CSS styles114    └── js/115        └── script.js       # Frontend JavaScript116```117 118## Contributing119 120Contributions are welcome! Please feel free to submit a Pull Request.121 122## License123 124This project is licensed under the MIT License - see the LICENSE file for details.125 126## Acknowledgments127 128- [Google Gemini API](https://ai.google.dev/)129- [Tavily API](https://tavily.com/)130- [Flask](https://flask.palletsprojects.com/)131- [Tailwind CSS](https://tailwindcss.com/)132- [PyPDF2](https://pypdf2.readthedocs.io/)