AI Resume Analyzer

Upload your resume (PDF), paste a job description, and get AI-powered analysis — match score, skill gaps, improvement suggestions, and likely interview questions.

Tech Stack

• Frontend: Next.js 16 + TypeScript + Tailwind CSS v4
• Backend: Python FastAPI
• AI: DeepSeek API (OpenAI-compatible)
• PDF Parsing: PyMuPDF

Project Structure

ai-resume-analyzer/
├── frontend/          # Next.js application
│   ├── app/           # Pages (home + result)
│   ├── components/    # React components
│   └── lib/           # Types + API client
├── backend/           # FastAPI application
│   └── app/
│       ├── routers/   # API endpoints
│       ├── services/  # PDF parsing, LLM client, prompt builder
│       └── models/    # Pydantic schemas
├── docs/              # Project documentation
├── .env.example       # API key template (copy to .env)
├── .gitignore
├── 启动项目.bat       # One-click start (Windows)
└── README.md

Quick Start

Prerequisites

• Python 3.11+ (recommended: 3.13)
• Node.js 18+
• npm
• An API key for DeepSeek (or any OpenAI-compatible LLM)

1. Configure API Key

cd backend
cp .env.example .env
# Edit .env and add your LLM_API_KEY

2. Start Backend

cd backend
pip install -r requirements.txt
uvicorn app.main:app --reload
# API running at http://localhost:8000

3. Start Frontend

Open a new terminal:

cd frontend
npm install
npm run dev
# App running at http://localhost:3000

One-click Start (Windows)

Double-click 启动项目.bat in the project root.

API Endpoints

• GET /api/health — Health check
• POST /api/analyze — Upload resume (PDF) + job description, get analysis

Documentation

Doc	Description
项目使用指南	Usage guide (Chinese)
项目架构说明	Architecture overview (Chinese)
启动命令	Startup commands (Chinese)