AI Cover Letter Generator

A modern web application that helps users generate and refine personalized cover letters using AI. Built with Django and powered by OpenAI's GPT models.

Table of Contents

• Features
• Demo
• Technology Stack
• Prerequisites
• Getting Started

Features

• Generate tailored cover letters based on your resume and job descriptions
• Context handling with similar examples
• Refine generated cover letters with natural language prompts
• Track revision history
• Upload and manage multiple resumes
• Mark cover letters as favorites to influence future generations

Demo

Technology Stack

• Django 5.1
• OpenAI GPT API
• PostgreSQL with pgvector for embeddings
• Tailwind CSS for styling
• HTMX for dynamic interactions
• Alpine.js for client-side state

Prerequisites

• Docker Compose
• uv
• OpenAI API key
• Google OAuth credentials

Getting Started

1. Clone the repository:

   git clone https://github.com/earthcomfy/cover_letter_generator.git
   cd cover_letter_generator

2. Install the project dependencies:

   uv sync --all-extras --dev

3. Set up environment variables:

   cp .env.example .env
   # Edit .env with your configuration:
   # - OPENAI_API_KEY
   # - GOOGLE_CLIENT_ID
   # - GOOGLE_CLIENT_SECRET

4. Start PostgreSQL with pgvector:

   docker compose up
   # This will start PostgreSQL with pgvector extension enabled
   # Default credentials:
   # - Database: cover_letter_generator
   # - User: postgres
   # - Password: postgres

5. Run migrations:

   uv run manage.py migrate

6. Start the development server:

   uv run manage.py runserver