🚀 InternSpot

Smart Internship Matching Powered by Natural Language Processing

About • Features • Tech Stack • Getting Started • Roadmap

💡 About

InternSpot is a modern recruitment platform designed to bridge the gap between candidates and their ideal internships. Unlike traditional job boards, InternSpot leverages Natural Language Processing (NLP) to analyze candidate resumes and automatically extract key skills and profile details.

The system is designed to match users with opportunities that fit their specific skillset, reducing the noise of job hunting.

✨ Key Features

• 📄 Intelligent Resume Parsing: Upload your resume (PDF/Docx) and let our NLP engine automatically scrape your skills, education, and experience.
• 👤 Instant Profile Building: No need to manually fill out long forms; your profile is generated based on your resume data.
• 🎯 Skill-Based Matching: (Current) View internship opportunities relevant to profile skills.
• ⚡ Modern Architecture: Built with a high-performance FastAPI backend and a reactive React frontend.

🛠 Tech Stack

Component	Technology	Description
Frontend		Dynamic user interface and state management.
Backend		High-performance API handling and asynchronous tasks.
Language		Core logic and scripting.
AI / NLP		Resume scraping and keyword extraction logic.

🚀 Getting Started

Follow these steps to set up the project locally.

Prerequisites

• Node.js (v14 or higher)
• Python (v3.8 or higher)

1. Clone the Repository

git clone [https://github.com/KavinMK05/InternSpot.git](https://github.com/KavinMK05/InternSpot.git)
cd InternSpot

2. Backend Setup (FastAPI)

Navigate to the backend directory (adjust folder name if different):

cd backend
# Create a virtual environment
python -m venv venv
# Activate the environment (Windows)
venv\Scripts\activate
# Activate the environment (Mac/Linux)
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Run the server
uvicorn main:app --reload

*The backend API will run at http://localhost:8000*

3. Frontend Setup (React)

Open a new terminal and navigate to the frontend directory:

cd frontend
# Install dependencies
npm install

# Start the React app
npm start

*The frontend will launch at http://localhost:3000*

🗺 Roadmap

We are actively working on making InternSpot a full-featured recruitment hub.

• Candidate Profile Creation via NLP
• Resume Upload & Parsing
• Job Feed Display (MVP)
• Recruiter Dashboard: Allow recruiters to sign up and post jobs.
• Dynamic Job Database: Moving from hardcoded listings to a live database.
• Advanced Matching Algorithm: Scoring candidates against job descriptions.

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📬 Contact

Project Link: https://github.com/KavinMK05/InternSpot

---

_{Built with ❤️ by KavinMK05}