Skip to main content
InterviewGuide Architecture

What is InterviewGuide?

InterviewGuide is an intelligent AI-powered platform designed to help job seekers prepare for interviews and HR professionals evaluate candidates. Built with Spring Boot 4.0, Java 21, and Spring AI, it combines modern AI capabilities with enterprise-grade infrastructure. The platform provides three core capabilities:

Resume Analysis

Upload resumes in multiple formats and receive AI-powered analysis with scoring and improvement suggestions

Mock Interviews

Practice interviews with AI-generated questions based on your resume, including intelligent follow-up questions

Knowledge Base

Build RAG-powered knowledge bases from documents and get accurate answers with vector search

Key Features

  • Multi-format Document Processing — Parse PDF, DOCX, DOC, TXT, and Markdown files with Apache Tika
  • Asynchronous Task Processing — Handle long-running operations with Redis Streams for scalable background jobs
  • Vector Search — Leverage PostgreSQL with pgvector for semantic search and RAG (Retrieval-Augmented Generation)
  • Streaming AI Responses — Real-time AI interactions using Server-Sent Events (SSE)
  • PDF Report Generation — Export detailed analysis and interview reports with iText 8
  • Rate Limiting — Built-in API protection with configurable rate limits
  • Duplicate Detection — Content-based hashing prevents redundant processing

Technology Stack

  • Spring Boot 4.0 — Application framework with virtual threads and modern Java features
  • Java 21 — Latest LTS version with pattern matching and virtual threads
  • Spring AI 2.0 — Unified AI integration framework supporting multiple LLM providers
  • PostgreSQL + pgvector — Relational database with vector storage for semantic search
  • Redis — Caching and message streaming with Redis Streams
  • Apache Tika 2.9.2 — Universal document parsing
  • iText 8 — Professional PDF generation
  • MapStruct 1.6.3 — Type-safe object mapping
  • Gradle 8.14 — Modern build tool
  • React 18.3 — Modern UI framework
  • TypeScript 5.6 — Type-safe JavaScript
  • Vite 5.4 — Lightning-fast build tool
  • Tailwind CSS 4.1 — Utility-first styling
  • React Router 7.11 — Client-side routing
  • Framer Motion 12.23 — Smooth animations
  • Recharts 3.6 — Data visualization
  • Docker & Docker Compose — Containerized deployment
  • MinIO / RustFS — S3-compatible object storage
  • Redisson — Advanced Redis client with distributed features

Use Cases

Upload your resume to receive detailed feedback on content, formatting, and areas for improvement. Practice interviews with AI-generated questions tailored to your background. Use the knowledge base to research interview topics and industry trends.

Quickstart Guide

Get InterviewGuide running locally in under 10 minutes

Docker Deployment

Deploy with one command using Docker Compose

API Reference

Explore the REST API documentation

Architecture

Understand the system design and components

Open Source

InterviewGuide is open source under the AGPL-3.0 license. Contributions are welcome!

View on GitHub

Star the repository, report issues, or submit pull requests

Build docs developers (and LLMs) love