whatisgithub

What is interview-guide?

snailclimb/interview-guide — explained in plain English

Analysis updated 2026-05-18

2,116JavaAudience · developerComplexity · 4/5Setup · hard

In one sentence

An open source AI platform for resume analysis, mock interviews with voice, and RAG powered interview prep.

Mindmap

mindmap
  root((repo))
    What it does
      Resume analysis
      Mock interviews
      Voice interviews
      Knowledge base RAG
    Tech stack
      Spring Boot
      Spring AI
      PostgreSQL pgvector
      Redis
    Use cases
      Interview practice
      Resume review
      Knowledge Q&A
    Audience
      Job seekers
      Developers
      HR teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Practice mock technical interviews with AI generated questions tailored to a specific track

USE CASE 2

Upload a resume and get an automated AI analysis with a downloadable PDF report

USE CASE 3

Build a searchable knowledge base from interview materials using retrieval augmented question answering

What is it built with?

JavaSpring BootSpring AIPostgreSQLRedisReactTypeScript

How does it compare?

snailclimb/interview-guidejuanjuandog/finsight-aielder-plinius/v3sp3r
Stars2,1161,1141,013
LanguageJavaJavaJava
Last pushed2026-05-25
MaintenanceMaintained
Setup difficultyhardmoderatehard
Complexity4/54/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Needs PostgreSQL with pgvector, Redis, and API keys for one or more LLM providers.

So what is it?

InterviewGuide is an open source AI interview assistant platform built with Spring Boot 4, Java 21, Spring AI, PostgreSQL with pgvector, Redis, and a React and TypeScript frontend. It combines resume analysis, mock interviews in both text and voice, interview scheduling, and a knowledge base with retrieval augmented question answering into one system. The resume module accepts PDF, DOCX, DOC, and TXT files, processes them asynchronously through Redis Stream so a user can watch progress update in real time, and automatically retries failed analysis up to three times while detecting duplicate uploads by content hash. Results can be exported as a structured PDF report. The mock interview module uses skill files to drive question generation across more than ten tracks such as Java backend, frontend, Python, algorithms, system design, testing, and AI agents, each track defining its own scope, difficulty spread, and reference material. It avoids repeating questions a user has already answered in earlier sessions, allocates interview time across stages like self introduction and technical review, and supports configurable multi round follow up questions. A shared scoring engine evaluates both text and voice interviews the same way, producing batch scores, structured output, a summary, and a fallback path when scoring fails, so results stay comparable across sessions. Voice interviews run over WebSocket using a single API key for speech recognition, synthesis, and the language model, targeting a first response delay of around two hundred milliseconds through sentence level parallel speech synthesis and automatic pause detection. Known limits include noticeable end to end delay from server side audio conversion, occasional echo without headphones, and audio interruptions on weak networks. The knowledge base module supports uploading PDF, DOCX, and Markdown files, chunking and embedding them with pgvector, and answering questions through streaming responses. The system supports multiple model providers including DashScope, LM Studio, Kimi, DeepSeek, and GLM, switchable from a settings page without editing source code. All functionality is free and open source, with no separate paid tier. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Explain how the Redis Stream based async resume analysis pipeline works in this project
Prompt 2
Show me how to add a new interview skill track to the mock interview module
Prompt 3
Walk me through configuring a different AI model provider like DeepSeek in the settings page

Frequently asked questions

What is interview-guide?

An open source AI platform for resume analysis, mock interviews with voice, and RAG powered interview prep.

What language is interview-guide written in?

Mainly Java. The stack also includes Java, Spring Boot, Spring AI.

How hard is interview-guide to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is interview-guide for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.