https://github.com/ajay-308/verbolearn
An advanced platform for enhancing English skills through interactive chat, personalized tasks, and resume optimization.
https://github.com/ajay-308/verbolearn
clerk clerkauth fastapi flask gemini nextjs14 postgresql prisma python webhook-server
Last synced: about 2 months ago
JSON representation
An advanced platform for enhancing English skills through interactive chat, personalized tasks, and resume optimization.
- Host: GitHub
- URL: https://github.com/ajay-308/verbolearn
- Owner: Ajay-308
- Created: 2024-09-27T09:49:37.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-09-18T06:30:10.000Z (9 months ago)
- Last Synced: 2025-09-18T08:33:26.697Z (9 months ago)
- Topics: clerk, clerkauth, fastapi, flask, gemini, nextjs14, postgresql, prisma, python, webhook-server
- Language: TypeScript
- Homepage: https://verbo-learn.vercel.app
- Size: 7.87 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🎯 Verbo Learn
**Your AI-powered career companion for job search success**
[🚀 Live Demo](https://youtu.be/h21nzukhIug?feature=shared) • [📖 Documentation](#-features) • [🐛 Report Bug](https://github.com/Ajay-308/verboLearn/issues) • [✨ Request Feature](https://github.com/Ajay-308/verboLearn/issues)
---
## 🌟 Overview
Verbo Learn is a comprehensive AI-powered platform designed to accelerate your job search journey. Whether you're looking to optimize your resume, ace your next interview, or improve your English communication skills, Verbo Learn provides intelligent tools to help you succeed in today's competitive job market.
## ✨ Key Features
### 📊 Resume Score Calculator
Transform your resume into a job-winning document with our intelligent analysis system.
- **📄 Smart Resume Upload** - Support for PDF, DOC, and DOCX formats
- **🎯 Job Matching Analysis** - AI-powered comparison with job requirements
- **📈 Detailed Scoring** - Comprehensive evaluation with actionable insights
- **💡 Improvement Suggestions** - Personalized recommendations to boost your score
- **🔍 Keyword Optimization** - ATS-friendly formatting suggestions
### 🤖 AI Interview Preparation
Practice makes perfect! Prepare for interviews with our AI interviewer Jarvis.
- **🎭 Realistic Mock Interviews** - Industry-specific question scenarios
- **🧠 AI Chatbot Jarvis** - Intelligent interviewer with natural conversation flow
- **📝 Job-Specific Questions** - Tailored questions based on your target role
- **📊 Performance Analytics** - Detailed feedback on your responses
- **🎯 Skill Assessment** - Identify strengths and areas for improvement
### 🗣️ English Language Enhancement
Master professional English communication with interactive AI conversations.
- **💬 Interactive Conversations** - Engaging dialogues on professional topics
- **✅ Real-time Grammar Correction** - Instant feedback on language usage
- **📚 Vocabulary Building** - Contextual word suggestions and improvements
- **🎯 Personalized Learning** - Adaptive content based on your proficiency level
- **📈 Progress Tracking** - Monitor your language improvement over time
## 🎬 Demo
*Experience the power of AI-driven career preparation*
## 🚀 Quick Start
### Prerequisites
- **Node.js** v16 or higher
- **Python** 3.8 or higher
- **npm** or **yarn** package manager
- **Git** for version control
### Installation
1. **Clone the repository**
```bash
git clone https://github.com/Ajay-308/verboLearn.git
cd verboLearn
```
2. **Install frontend dependencies**
```bash
npm install
# or
yarn install
```
3. **Set up the backend**
```bash
cd model
pip install -r requirements.txt
```
4. **Configure environment variables**
```bash
# Create .env file in root directory
cp .env.example .env
# Edit .env with your configuration
```
### Running the Application
1. **Start the backend server**
```bash
cd model
python api.py
# or
uvicorn app:app --host 0.0.0.0 --port 8000 --reload
```
2. **Start the frontend development server**
```bash
# In a new terminal, from the root directory
npm run dev
```
3. **Open your browser** and navigate to `http://localhost:3000`
## 💡 Usage Guide
### 📊 Resume Score Calculation
1. **Upload Your Resume**
- Click "Upload Resume" and select your file (PDF, DOC, DOCX)
- Wait for the document to be processed
2. **Add Job Description**
- Paste the job description or requirements
- Include key skills and qualifications
3. **Get Your Score**
- Receive a detailed compatibility score (0-100)
- Review personalized improvement suggestions
- Download an optimized version of your resume
### 🤖 Interview Preparation
1. **Set Up Your Session**
- Input the job description for your target role
- Select interview difficulty level
2. **Practice with Jarvis**
- Engage in realistic mock interview scenarios
- Answer questions using voice or text input
- Receive real-time feedback and suggestions
3. **Review Performance**
- Analyze your responses and improvement areas
- Practice specific question types
- Track your progress over multiple sessions
### 🗣️ English Language Practice
1. **Start a Conversation**
- Choose from professional conversation topics
- Set your current proficiency level
2. **Interactive Learning**
- Engage in natural conversations with the AI
- Receive instant grammar and vocabulary feedback
- Practice pronunciation with voice recognition
3. **Track Progress**
- Monitor your improvement metrics
- Review corrected sentences and explanations
- Set learning goals and milestones
## 🏗️ Architecture
```
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ React Frontend│───▶│ FastAPI Backend│───▶│ AI/ML Models │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ User Interface│ │ API Endpoints │ │ NLP Processing│
└─────────────────┘ └──────────────────┘ └─────────────────┘
```
## 🛠️ Tech Stack
| Component | Technology | Purpose |
|-----------|------------|---------|
| **Frontend** | React 18, TypeScript | Interactive user interface |
| **Backend** | FastAPI, Python | API server and business logic |
| **AI/ML** | OpenAI GPT, spaCy, NLTK | Natural language processing |
| **Database** | PostgreSQL/MongoDB | User data and analytics |
| **Authentication** | JWT, OAuth 2.0 | Secure user management |
| **Deployment** | Docker, AWS/Vercel | Scalable cloud hosting |
## 📋 API Endpoints
### Resume Analysis
```http
POST /api/resume/analyze
Content-Type: multipart/form-data
{
"resume": "file",
"job_description": "string"
}
```
### Interview Session
```http
POST /api/interview/start
Content-Type: application/json
{
"job_description": "string",
"difficulty": "beginner|intermediate|advanced"
}
```
### Language Practice
```http
POST /api/language/conversation
Content-Type: application/json
{
"message": "string",
"proficiency_level": "string"
}
```
## 🤝 Contributing
We welcome contributions from the community! Here's how you can help:
### Development Setup
1. **Fork the repository**
```bash
git fork https://github.com/Ajay-308/verboLearn.git
```
2. **Create a feature branch**
```bash
git checkout -b feature/amazing-feature
```
3. **Make your changes**
- Follow our coding standards
- Add tests for new features
- Update documentation as needed
4. **Submit a pull request**
```bash
git commit -m 'Add some amazing feature'
git push origin feature/amazing-feature
```
### Contribution Guidelines
- 📝 **Code Style** - Follow ESLint and Prettier configurations
- 🧪 **Testing** - Write unit tests for new features
- 📚 **Documentation** - Update README and inline comments
- 🔍 **Review Process** - All PRs require review before merging
## 📈 Performance & Analytics
| Metric | Value |
|--------|-------|
| **Resume Analysis Time** | < 3 seconds |
| **Interview Response Time** | < 1 second |
| **Language Correction Accuracy** | 95%+ |
| **User Satisfaction Score** | 4.8/5.0 |
| **Supported File Formats** | PDF, DOC, DOCX |
## 🔍 Troubleshooting
Common Issues and Solutions
### Backend won't start
**Solution:** Check if Python dependencies are installed
```bash
cd model
pip install -r requirements.txt
python api.py
```
### Frontend build errors
**Solution:** Clear node modules and reinstall
```bash
rm -rf node_modules package-lock.json
npm install
```
### File upload issues
**Solution:** Check file size limits and supported formats
- Maximum file size: 10MB
- Supported formats: PDF, DOC, DOCX
## 📊 Roadmap
- [ ] 🎯 **Advanced Resume Templates** - Industry-specific resume formats
- [ ] 🎥 **Video Interview Practice** - Webcam-based mock interviews
- [ ] 📱 **Mobile Application** - iOS and Android apps
- [ ] 🌐 **Multi-language Support** - Support for multiple languages
- [ ] 📊 **Advanced Analytics** - Detailed progress tracking
- [ ] 🤝 **Team Collaboration** - Shared workspace for teams
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🙏 Acknowledgments
- [OpenAI](https://openai.com/) for GPT models
- [FastAPI](https://fastapi.tiangolo.com/) for the excellent web framework
- [React](https://reactjs.org/) community for frontend tools
- All contributors and beta testers
## 📞 Contact & Support
- **Author:** [Ajay-308](https://github.com/Ajay-308)
- **Email:** [contact@verbolearn.com](mailto:contact@verbolearn.com)
- **Issues:** [GitHub Issues](https://github.com/Ajay-308/verboLearn/issues)
- **Discussions:** [GitHub Discussions](https://github.com/Ajay-308/verboLearn/discussions)
---
**⭐ Star this repository if it helped you in your career journey!**
[](https://github.com/Ajay-308/verboLearn/stargazers)
[](https://github.com/Ajay-308/verboLearn/network)
**Made with ❤️ for job seekers worldwide**