Resume Oracle

AI-driven resume and cover letter optimization platform that transforms job descriptions into tailored applications.

Overview

Resume Oracle is a guided, step-by-step workflow that helps job seekers create highly targeted resumes and cover letters by analyzing job descriptions and matching them with existing experience. Unlike traditional resume builders, it starts with the job requirements and optimizes your profile accordingly.

Key Features

• Job-Description Centered: Workflow driven by specific job requirements rather than generic templates
• Zero Hallucination: Uses only your existing experience - no fictional content added
• Multi-Step Coaching: 7-step guided process with persistent state management
• AI-Powered Matching: Intelligent scoring and gap analysis for profile sections vs. job requirements
• ATS-Optimized Export: Clean Markdown output optimized for applicant tracking systems

Workflow Steps

1. Profile Sections - Import and structure your existing experience
2. Job Description - Paste target job description and company context
3. Requirements Matching - AI extracts and matches job requirements to your profile
4. Profile Enhancement - Enhance sections with missing requirements
5. Resume Generation - Create tailored resume sections
6. Resume Editor - Edit and export final resume as Markdown/PDF
7. Cover Letter - Generate personalized cover letter

Tech Stack

• Frontend: Next.js 15, React 18, TypeScript, Tailwind CSS, shadcn/ui
• State Management: Redux Toolkit with persistence
• AI Integration: LangChain.js with custom useLlmService hook
• Type Safety: Zod schemas for LLM output validation

Setup & Installation

Prerequisites

LLM API Key Required: This application requires a Gemini API key (or other supported services) to function. You can provide it either:

• As environment variable NEXT_PUBLIC_GEMINI_API_KEY in .env.local
• Manually through the app UI

Getting a Free Gemini API Key

1. Visit Google AI Studio
2. Sign in with your Google account
3. Click "Create API key"
4. Copy your API key

Note: If you don't set the environment variable, you can enter your API key directly in the application interface.

Documentation

• Development Guide - Architecture, patterns, and development workflow
• Feature Overview - Detailed feature descriptions
• UI Flow - Complete user journey documentation

Contributing

This project follows strict TypeScript patterns and uses AI-assisted development. See Development Guide

TODOS

• handle no APIKEY provided error properly
• custom hook to scroll to top of page after each step change
• on final step completion, show confirmation modal to start over (clear all state, except profile sections)
• add setting to reset all redux store
• add setting to reset all LLM cache
• provide a way to regenerate Resume and relevant steps, force re-run of LLM
• error handling
• streaming LLM responses
• add feature tests
• add e2e tests
• link sharing embedding preview