🚀 Job-Finder

Job-Finder Logo

GitHub license GitHub stars GitHub forks GitHub issues

Job-Finder is an innovative web application that leverages AI to match job seekers with their ideal positions based on their CVs. Our platform provides a seamless, intelligent job search experience, bridging the gap between talented individuals and their dream careers.

🌟 Features

  • 📄 Smart CV parsing and analysis
  • 🧠 AI-powered job matching
  • 🔍 Advanced search and filtering options
  • 📊 Interactive dashboard for job seekers
  • 🔔 Customizable job alerts
  • 💼 One-click apply functionality
  • 📈 Career path visualization
  • 🤝 In-app messaging for networking

🛠️ Tech Stack

  • Frontend: React.js, Material-UI
  • Backend: Python, FastAPI
  • Database: PostgreSQL
  • AI/ML: Hugging Face Transformers
  • DevOps: Docker, Kubernetes

🚀 Getting Started

Prerequisites

  • Node.js (v14+)
  • Python (v3.11+)
  • Docker
  • Streamlit

Installation

  1. Clone the repository:

    git clone https://github.com/Mohamednajdawi/Job-Finder.git
    
  2. Navigate to the project directory:

    cd Job-Finder
    
  3. Install frontend dependencies:

    cd frontend
    npm install
    
  4. Install backend dependencies:

    cd ../backend
    pip install -r requirements.txt
    
  5. Start the development servers:

    # In the frontend directory
    npm start
    
    # In the backend directory
    uvicorn main:app --reload
    
  6. Run the Streamlit application:

    streamlit run src/job_applyer/app.py
    

Visit http://localhost:3000 to see the main app in action! For the Streamlit interface, check the URL provided in the terminal after running the Streamlit command.

👨‍💻 For Developers

To quickly run the Streamlit application, use the following command from the root directory:

streamlit run src/job-applyer/app.py

This will start the Streamlit server and open the application in your default web browser. If it doesn't open automatically, check the terminal output for the local URL.

📘 Documentation

For detailed documentation, please visit our Wiki.

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for more details.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

📞 Contact

Mohamed Najdawi - @MohamedNajdawi - mohamed@jobfinder.com

Project Link: https://github.com/Mohamednajdawi/Job-Finder

🙏 Acknowledgments

  • OpenAI for their groundbreaking work in AI
  • Anthropic for their advanced language models
  • All our amazing contributors and users!

Made with ❤️ by the Job-Finder Team