<<<<<<< HEAD
AI-Powered Career Mentoring Platform for Students and Fresh Graduates
SkillBridge AI is a comprehensive career development platform that leverages artificial intelligence to help students and fresh graduates accelerate their career growth through personalized guidance, skill assessment, and learning roadmaps.
- AI Career Mentor - Chat with an AI mentor powered by Groq (Llama 3.3 70B) for personalized career guidance
- Resume Analyzer - Upload your resume for AI-powered analysis with ATS scoring and improvement suggestions
- Learning Roadmaps - Generate personalized learning paths based on your career goals and current skills
- GitHub Profile Analyzer - Get detailed analysis of your GitHub profile with actionable suggestions
- Mock Interviews - Practice technical interviews with AI-generated questions and feedback
- Progress Tracker - Track your learning journey and skill development
- Job Matching - Find relevant job opportunities based on your skills and preferences
- RAG (Retrieval-Augmented Generation) - Context-aware responses using ChromaDB vector database
- Real-time Streaming - Server-Sent Events for smooth AI response streaming
- Authentication - Secure JWT-based authentication with Argon2 password hashing
- Database Migrations - Alembic for database version control
- Comprehensive Testing - Unit and integration tests with pytest
- FastAPI - Modern, fast Python web framework
- SQLAlchemy - ORM with async support
- Alembic - Database migration tool
- Groq API - LLM inference (Llama 3.3 70B Versatile)
- ChromaDB - Vector database for RAG
- Argon2 - Secure password hashing
- PyMuPDF - PDF parsing for resume analysis
- Pytest - Testing framework
- Next.js 16 - React framework with Turbopack
- TypeScript - Type-safe JavaScript
- Tailwind CSS - Utility-first CSS framework
- Axios - HTTP client
- React Markdown - Markdown rendering
- Lucide React - Icon library
- PostgreSQL - Production database (async with asyncpg)
- SQLite - Development/testing database (async with aiosqlite)
- Python 3.11+
- Node.js 18+
- Git
-
Clone the repository
git clone https://github.com/abhisheksinghcodebase/Skillbridge-AI.git cd Skillbridge-AI/backend -
Create virtual environment
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
-
Install dependencies
pip install -r requirements.txt
-
Set up environment variables
cp .env.example .env # Edit .env and add your API keys -
Run database migrations
alembic upgrade head
-
Start the backend server
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
-
Navigate to frontend directory
cd ../frontend -
Install dependencies
npm install
-
Set up environment variables
cp .env.example .env.local # Edit .env.local if needed -
Start the development server
npm run dev
-
Open your browser
http://localhost:3000
You'll need the following API keys:
- Groq API Key (Required) - Get free key at console.groq.com
- GitHub Token (Optional) - For GitHub profile analysis
Add these to your backend/.env file:
GROQ_API_KEY=your_groq_api_key_here
GITHUB_TOKEN=your_github_token_here # Optional- Register/Login - Create an account or login
- Upload Resume - Get AI-powered resume analysis
- Generate Roadmap - Create personalized learning paths
- Chat with Mentor - Ask career-related questions
- Analyze GitHub - Get profile improvement suggestions
- Practice Interviews - Prepare with AI-generated questions
- Track Progress - Monitor your learning journey
Skillbridge-AI/
├── backend/
│ ├── alembic/ # Database migrations
│ ├── app/
│ │ ├── api/routers/ # API endpoints
│ │ ├── core/ # Configuration & security
│ │ ├── models/ # SQLAlchemy models
│ │ ├── schemas/ # Pydantic schemas
│ │ ├── services/ # Business logic
│ │ └── main.py # FastAPI application
│ ├── tests/ # Test suite
│ ├── requirements.txt
│ └── .env.example
├── frontend/
│ ├── app/
│ │ ├── (dashboard)/ # Dashboard pages
│ │ ├── auth/ # Authentication pages
│ │ └── layout.tsx
│ ├── lib/ # Utilities & API client
│ ├── contexts/ # React contexts
│ ├── package.json
│ └── .env.example
└── README.md
cd backend
# Run all tests
pytest
# Run with coverage
pytest --cov=app --cov-report=html
# Run specific test categories
pytest -m unit # Unit tests only
pytest -m integration # Integration tests only
pytest tests/unit/ # All unit tests- Unit tests for all service layers
- Integration tests for API endpoints
- Database constraint and transaction tests
- 80%+ code coverage target
- Argon2 password hashing (winner of Password Hashing Competition)
- JWT token-based authentication
- CORS protection
- Input validation with Pydantic
- SQL injection protection via SQLAlchemy ORM
- Rate limiting ready (can be configured)
Once the backend is running, visit:
- Swagger UI: http://localhost:8000/docs
- ReDoc: http://localhost:8000/redoc
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License.
Abhishek Singh
- GitHub: @abhisheksinghcodebase
- Groq for providing fast LLM inference
- FastAPI team for the amazing framework
- Next.js team for the incredible developer experience
- All open-source contributors
For support, email abhisheksinghcodebase@gmail.com or open an issue on GitHub.
65bb7092805ad9e79d6d3466ddc2be257a4de85c