Zhiyuan Song
Projects Research Notes 中文
← Home

Full stack · MIT · since Mar 2025 · last maintenance ~three months ago

TalentSync

AI-Powered Career Assistant

TalentSync is a full-stack AI career assistant built with React, Express, and MongoDB. It integrates OpenAI and Google Gemini for multi-angle resume–job matching (ATS, ranking, HR lens, technical lens), personalized cover letters with PDF export, job tracking with application states, and Stripe subscriptions (Free / Premium / Enterprise) plus Google OAuth sign-in.

Demo link, open repository, and feature details are below; environment variables, REST API, and deployment notes follow the GitHub README.

Core features

Resume–job matching

  • ATS view: keyword fit, format checks, pass-probability style scoring
  • Ranking view: predicted percentile vs top candidates
  • HR lens: first impression, interview tips, communication gaps
  • Technical lens: credibility, risk flags, likely interview topics

Smart cover letters

  • Generate tailored letters from resume + target role
  • Highlight experience-to-requirement fit
  • Multiple languages and tones; PDF export

Job tracking

  • Parse JDs into structured records
  • Statuses: saved, applied, interviewing, offer, rejected, etc.

Accounts

  • Email registration / sign-in
  • Google OAuth 2.0
  • JWT; plan tiers with Stripe billing

Stripe subscriptions

Full commercial path: Stripe checkout, webhooks, differentiated entitlements per tier.

Capability Free Premium Enterprise
Gemini models Unlimited Unlimited Unlimited
GPT-4o analysis ~1/day Unlimited Unlimited
GPT-o1 analysis — — Unlimited
Cover letter generation Yes Yes Yes

Exact quotas and pricing follow README.md and your Stripe Dashboard configuration.

Tech stack

Frontend Version / notes (from README)
Framework React 18.2
Routing react-router-dom v6.30
State Redux Toolkit v2.6
Styling Tailwind CSS + Material-UI v7
Motion / PDF / charts Framer Motion; jspdf, html2pdf.js; ECharts v5.6
Backend & deploy Notes
Runtime / framework Node.js + Express.js v4.21
Database MongoDB + Mongoose v8.13
Auth JWT + Google OAuth + bcryptjs
AI OpenAI (GPT-4o, GPT-o1) + Google Gemini
Payments Stripe v18
Files multer, pdf-parse, pdfkit, etc.
Deploy Frontend Vercel; backend Railway; database MongoDB Atlas

Repository layout (summary)

TalentSync/
├── backend/           # Express: models, controllers, routes, services
├── frontend/          # React: pages, components, store, services
├── README.md
├── PROJECT_DOCUMENTATION.md
├── CONTRIBUTING.md
└── LICENSE

Quick start

Prereqs: Node.js ≥ 16, MongoDB (local or Atlas), npm or yarn.

git clone https://github.com/songzhiyuan98/TalentSync.git
cd TalentSync   # or your local folder name

cd backend && npm install
cd ../frontend && npm install

# Configure backend/.env and frontend/.env:
# MONGO_URI, OPENAI_API_KEY, GEMINI_API_KEY, JWT_SECRET,
# Google OAuth, Stripe, API_URL, etc. — see README

cd backend && npm start    # default :3001
cd frontend && npm start   # default :3000

Open http://localhost:3000.

API summary

Base prefix /api/. Full list in PROJECT_DOCUMENTATION.md.

  • Auth: POST /api/auth/register, login, GET /api/auth/google, /me, logout
  • Resumes: upload, list, active, set-active, delete
  • Jobs: parse, save, user list, detail
  • Analysis: create, detail, list
  • Cover letters: generate, detail, PDF download
  • Billing: checkout session, subscription status, cancel subscription

Security

  • JWT; bcrypt for passwords
  • Google OAuth 2.0
  • Stripe payment flow
  • Upload size limits (e.g. 10MB), CORS, Helmet, etc.

Contributing & license

Pull requests welcome; process in CONTRIBUTING.md.

License: MIT.

Credits and third-party services are listed in the GitHub README (OpenAI, Google Gemini, Stripe, Vercel, Railway, etc.).