AI Resume Analyser — AI skill for Claude Code

AI Resume Analyzer Monorepo

Production-style monorepo for an AI Resume Analyzer with Python microservices and a Next.js frontend. The platform supports resume uploads (PDF/DOCX/TXT), ATS scoring, resume-to-job matching, skill gap analysis, recruiter ranking, and AI-generated content.

Architecture Overview

• apps/frontend: Next.js App Router UI for students and recruiters
• services/api-gateway: Entry point with auth, rate limiting, and routing
• services/auth-service: JWT auth, user management, refresh tokens
• services/resume-service: Resume upload, parsing, sectioning, storage
• services/analysis-service: ATS scoring, AI analysis, embeddings
• services/ranking-service: Candidate ranking and comparisons
• libs/shared: Shared SQLAlchemy models and utilities
• infra/nginx: Reverse proxy to frontend and API
• infra/k8s: Kubernetes manifests

Quick Start (Docker Compose)

docker compose up --build

Optional shortcut:

make up

The stack runs behind nginx on:

• Frontend: http://localhost:8080
• API: http://localhost:8080/api/v1

To enable AI-powered outputs, set `OPENROUTER_API_KEY` in `.env.example` (or your own env file).

Default Environment

The project runs using `.env` if present; otherwise `.env.example`. Update your local `.env` if you want custom secrets or model choices.

macOS Setup (Intel + Apple Silicon)

Prerequisites

**Docker Desktop:**

1. Download Docker Desktop for macOS
2. Install and start Docker Desktop
3. Verify installation: docker --version && docker compose version

**Other Requirements:**

• Git
• At least 8GB RAM available (16GB recommended for comfortable development)
• 20GB free disk space for images and volumes

One-Command Startup

git clone 
cd AI-Resume-Analyser
docker compose up --build

Wait for all services to show as "healthy" (typically 2-3 minutes on first run).

Verify the S