JobNaut is a production-ready, AI-powered career coaching platform that revolutionizes job search with personalized recommendations, real-time skill gap analysis, and intelligent career guidance. Built with enterprise-grade architecture (tRPC, Nuxt 3, PostgreSQL) and comprehensive testing (286+ tests, 85% coverage), JobNaut helps job seekers discover opportunities, optimize their careers, and receive AI-driven coaching powered by Hugging Face and LangChain.

🚀 10/10 Production Ready | 🤖 175+ E2E Tests | 📊 4 Grafana Dashboards | ⚡ Redis Caching | 🔒 Enterprise Security

JobNaut goes beyond traditional job boards. We provide:

• 🎯 AI Career Coach: Personalized career guidance powered by advanced AI models
• 📊 Skill Gap Analysis: Identify skills to learn for your dream job
• 🤖 Smart Job Matching: AI-driven recommendations based on your profile
• 📈 Market Insights: Real-time job market trends and salary analytics
• ✨ Resume Optimization: AI-powered resume tips for better applications
• 🔄 Career Transition: Expert guidance for changing careers

Perfect for: Job seekers, career changers, recruiters, HR professionals, career coaches

Tech Stack: Node.js, tRPC, Nuxt 3, Vue 3, PostgreSQL, Prisma, Redis, Playwright, Docker

• 🔍 Smart Job Discovery: AI-powered job search with personalized recommendations
• 📊 Skill Assessment: Identify skills gaps and get learning recommendations
• 💬 Career Coaching: 24/7 AI career coach for guidance and advice
• 📝 Resume Optimization: Get AI-powered tips to improve your resume
• 📈 Market Insights: Understand salary trends and demand for your skills

• 🔄 Transition Planning: AI-guided career transition roadmap
• 🎯 Skill Mapping: See how your current skills transfer to new roles
• 📚 Learning Path: Personalized learning recommendations for new career
• 💼 Job Matching: Find roles that match your transferable skills

• 🤖 AI-Powered Matching: Intelligent candidate-job matching
• 📊 Market Analytics: Real-time job market trends and insights
• 🎯 Skill Analytics: Understand skill demand in your industry
• 📈 Talent Pipeline: Build data-driven talent acquisition strategies

• 🏗️ Modern Stack: tRPC, Nuxt 3, Vue 3, Prisma, Redis
• 🧪 Comprehensive Tests: 286+ tests with Playwright E2E
• 🐳 Production Ready: Docker, CI/CD, monitoring, backups
• 📚 Full Documentation: 32 guides covering all aspects

• Real-time job listings from multiple sources
• Advanced search with filters (location, salary, experience level)
• Skill-based job recommendations
• Fast search powered by Meilisearch

• Personalized career guidance and advice with AI career coach
• Interactive chatbot powered by Hugging Face models for career coaching
• Advanced skill gap analysis tool with personalized improvement suggestions
• AI-powered resume optimization tips for better job applications
• Career transition assistant for switching industries or roles

• Comprehensive profile with skills and experience
• Saved jobs tracking with application status
• Personalized job recommendations
• Career progress monitoring

• Skill demand trend analysis for 2025 job market
• Salary range visualization and compensation insights
• Market insights and personalized job market recommendations
• Career path suggestions with growth opportunity analysis
• Professional skills assessment and competency mapping

• Secure authentication with Clerk
• Data encryption for sensitive information
• Rate limiting and DDoS protection
• Comprehensive input validation

• Node.js with tRPC for type-safe API development
• PostgreSQL database with Prisma ORM
• Meilisearch for fast, relevant search
• Express for web server functionality
• Clerk for authentication and user management

• Nuxt 3 (Vue.js) for modern, responsive UI
• Tailwind CSS for styling
• Vitest and Jest for comprehensive testing
• Responsive design for mobile and desktop

• Python FastAPI for AI microservices
• Hugging Face Transformers for NLP models
• LangChain for conversation management
• JSearch API for job data aggregation

• Docker containerization for easy deployment
• GitHub Actions for CI/CD
• k6 for load testing
• Winston for logging and monitoring

• Node.js 18+
• PostgreSQL
• Docker (optional, for containerized deployment)
• Python 3.8+ (for AI services)

1. Clone the repository:

git clone https://github.com/mrkingsleyobi/jobnaut.git
cd jobnaut

2. Install dependencies:

# Backend
npm install

# Frontend
cd frontend
npm install
cd ..

3. Set up environment variables:

# Backend environment (.env)
cp .env.example .env
# Edit .env with your configuration

# Frontend environment (frontend/.env)
cp frontend/.env.example frontend/.env
# Edit frontend/.env with your configuration

4. Run the development server:

# Start backend
npm run dev

# Start frontend (in another terminal)
cd frontend
npm run dev

5. Run AI services (optional):

# Navigate to AI services directory
cd ai-services
pip install -r requirements.txt
python main.py

docker-compose up -d

# Build and push images
docker build -t jobnaut/backend:latest .
docker build -t jobnaut/frontend:latest ./frontend

# Deploy with production configuration
docker-compose -f docker-compose.prod.yml up -d

npm test

cd frontend
npm test

# Install k6
npm install -g k6

# Run load tests
k6 run tests/load-testing/job-search-test.js
k6 run tests/load-testing/auth-test.js

• Production Checklist - Pre-deployment verification
• Deployment Guide - Complete deployment procedures
• Environment Variables - Configuration reference
• API Reference - Complete API documentation

• Operations Runbook - Daily, weekly, monthly operational tasks
• Monitoring Setup - Grafana, Prometheus, and alerting
• Troubleshooting Guide - Common issues and solutions
• Disaster Recovery - Recovery procedures and failover

• Scaling Guide - Horizontal scaling, database replication, CDN
• Cost Optimization - Resource optimization and savings

• Security Hardening - Security checklist and incident response
• Security Enhancements - Additional security features

• Performance Optimization
• Load Testing
• Data Pipeline
• Implementation Summary
• Validation Report

# Clone and install
git clone https://github.com/mrkingsleyobi/jobnaut.git
cd jobnaut
npm install && cd frontend && npm install && cd ..

# Configure environment
cp .env.example .env
cp frontend/.env.example frontend/.env

# Start services
docker-compose up -d postgres redis meilisearch
npm run dev
cd frontend && npm run dev

# Deploy to staging
./scripts/deploy.sh --env=staging

# Run health checks
./scripts/health-check.sh --env=staging

# Pre-deployment checklist
./scripts/pre-deployment-check.sh

# Deploy with zero-downtime
./scripts/deploy.sh --env=production --strategy=rolling

# Monitor deployment
./scripts/monitor-deployment.sh

# Rollback if needed
./scripts/rollback.sh

See Deployment Guide for detailed instructions.

We welcome contributions! Please follow these guidelines:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Write tests for your changes (aim for >80% coverage)
4. Ensure all tests pass (npm test && cd frontend && npm test)
5. Follow code style (run npm run lint)
6. Commit with descriptive messages (follow conventional commits)
7. Push to your fork (git push origin feature/AmazingFeature)
8. Open a pull request with a clear description

• Follow the coding standards in existing files
• Add tests for new features
• Update documentation for API changes
• Keep commits atomic and well-described
• Run security checks before submitting

See CONTRIBUTING.md for detailed guidelines.

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

• Node.js and npm packages: Various open-source licenses
• Clerk: Commercial license required for production
• Hugging Face: Apache 2.0
• PostgreSQL: PostgreSQL License
• Redis: BSD 3-Clause
• Meilisearch: MIT License

• Clerk for authentication services
• Hugging Face for AI models
• Meilisearch for search technology
• JSearch for job data APIs

JobNaut is production-ready with enterprise-grade features:

• ✅ Containerized deployment with Docker
• ✅ Kubernetes orchestration ready
• ✅ Automated CI/CD pipeline with GitHub Actions
• ✅ Zero-downtime deployment support
• ✅ Auto-scaling policies configured

• ✅ Comprehensive monitoring (Grafana + Prometheus)
• ✅ Real-time alerting (PagerDuty, Slack)
• ✅ Centralized logging (Loki)
• ✅ Performance tracking and metrics
• ✅ Health checks and readiness probes

• ✅ Security hardening implemented
• ✅ Data encryption (at rest and in transit)
• ✅ Rate limiting and DDoS protection
• ✅ Input validation and sanitization
• ✅ Secrets management (AWS Secrets Manager)
• ✅ Regular security audits

• ✅ Database replication and backups
• ✅ Disaster recovery procedures (RTO: 30min, RPO: 15min)
• ✅ Failover strategies tested
• ✅ Load testing validated (2000+ req/s)
• ✅ 99.9% uptime target

• ✅ Complete API documentation
• ✅ Operations runbooks
• ✅ Troubleshooting guides
• ✅ Security procedures
• ✅ Scaling playbooks

Start helping job seekers today with AI-powered career navigation!

• Email: [email protected]
• Documentation: docs/
• Status Page: https://status.jobnaut.com

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Security: [email protected] (for security issues only)

• Operations Runbook: docs/OPERATIONS_RUNBOOK.md
• On-Call Guide: See runbook
• Incident Response: docs/DISASTER_RECOVERY.md

AI Career Coach | Job Search Platform | Skill Gap Analysis | Career Development AI | Job Matching Algorithm | Resume Optimization

• AI-powered job search platform 2025
• Intelligent career guidance system
• Automated skill gap analysis tool
• Personalized job recommendations AI
• Career transition assistant
• Remote work job finder
• AI career coaching chatbot
• Professional skills assessment platform
• Job market analytics dashboard
• AI-powered resume optimization
• Career path planning tool
• Employment opportunity discovery
• Talent acquisition AI
• HR recruitment software
• Job search automation platform

tRPC API | Nuxt 3 Application | Vue 3 Framework | PostgreSQL Database | Prisma ORM | Redis Caching | Playwright E2E Testing | Docker Deployment | GitHub Actions CI/CD | Prometheus Monitoring | Grafana Dashboards | Enterprise Architecture

Job Seekers | Career Changers | HR Professionals | Recruiters | Talent Acquisition | Career Coaches | Software Engineers | Full-Stack Developers | DevOps Engineers | Engineering Managers

Recommended Topics for Discoverability:

ai-powered-job-search, job-matching-ai, career-development-ai, skill-gap-analysis, ai-career-coach, resume-optimization, job-search-automation, career-transition, ai-recruitment, job-market-analytics, trpc, nuxt3, prisma, playwright, redis

👉 See GitHub Topics Recommendations for detailed analysis of low-competition, high-growth topics.

👉 See GitHub SEO Optimization Guide for complete SEO strategy.