JD Generator - AI Job Description Creator

A modern web application for generating professional job descriptions using AI (Google Gemini), featuring customizable sections, rich text editing, and intelligent candidate assessment tests.

Overview

JD Generator streamlines the recruitment process by leveraging Google Gemini AI to create tailored job descriptions for different platforms and audiences. The application offers real-time editing, multiple style options, and automated candidate assessment capabilities.

Key Features

Screenshots

Core Features

AI-Powered Job Description Generation

The application uses Google Gemini AI to generate professional, engaging job descriptions tailored to your specific needs.

Customization Options:

• Job Title - Enter any position (e.g., "Junior Cybersecurity Engineer")
• Channel Selection - Social Media, Pracuj.pl, or OLX
• Style Options - Classic, Lifestyle, or Growth-oriented
• Candidate Profile - Students, Experienced professionals, or Career returners
• Section Control - Check/uncheck specific sections to include

Rich Text Editor

Edit generated content in real-time with a powerful formatting toolbar:

• Bold, Italic, and Underline text
• Bullet lists and structured content
• Click-to-edit functionality
• Instant preview updates
• One-click design refactoring

Candidate Assessment Tests

Generate intelligent assessment tests to evaluate candidates:

Test Generation:

1. Click "Generate Test" button
2. AI creates 5 relevant questions based on the job description
3. Questions are tailored to the position requirements

Test Evaluation:

1. Candidates answer all questions in a popup interface
2. Submit answers for automatic scoring
3. Receive detailed feedback and scoring breakdown
4. AI evaluates answers based on job requirements

Technical Architecture

Backend Stack

Frontend Stack

• HTML5 - Semantic markup
• CSS3 - Modern styling with gradients and animations
• JavaScript - Interactive functionality
• Dark Mode - Eye-friendly interface

Key Technologies

# Core Dependencies
fastapi==0.104.1
uvicorn==0.24.0
google-generativeai==0.3.1
python-dotenv==1.0.0
jinja2==3.1.2

Project Structure

.
├── main.py                 # FastAPI application
├── gemini_client.py        # Gemini API client
├── templates/
│   └── job_post.html      # Job post template
├── .env                    # Environment variables
├── requirements.txt        # Python dependencies
├── cache.json             # Generated content cache
└── README.md              # Documentation

API Endpoints

Main Endpoints

GET /

• Main application interface
• Serves the job description generator UI

POST /generate

• Generate job descriptions
• Parameters: title, channel, style, profile, sections

POST /generate-test

• Generate candidate assessment test
• Returns 5 AI-generated questions

POST /score-test

• Score candidate test answers
• Returns detailed feedback and scoring

Installation & Setup

# Clone repository
git clone <your-repo-url>
cd <project-directory>

# Create virtual environment
python -m venv venv

# Activate virtual environment
# On Linux/Mac:
source venv/bin/activate
# On Windows:
venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

GEMINI_API_KEY=your_gemini_api_key_here
GEMINI_MODEL=gemini-2.5-pro

# Start server with auto-reload
uvicorn main:app --reload

# Or specify custom port
uvicorn main:app --reload --port 8001

http://localhost:8000

Usage Guide

Step 1: Configure Job Details

1. Enter the Job Title (e.g., "Senior Python Developer")
2. Select the Channel where the job will be posted
3. Choose the Style that matches your company culture
4. Select the Candidate Profile you're targeting

Step 2: Customize Sections

Check or uncheck sections to include:

• Job Overview
• Key Responsibilities
• Required Qualifications
• Preferred Skills
• Benefits & Perks
• Company Culture
• Application Process

Step 3: Generate & Edit

1. Click "Generate Job Post"
2. Wait for AI to create the description
3. Click directly in the preview to edit text
4. Use formatting toolbar for styling
5. Click "Refactor Design" for variations

Step 4: Candidate Assessment

1. Click "Generate Test" button
2. Review the 5 AI-generated questions
3. Share test link with candidates
4. Candidates submit answers
5. View automatic scoring and feedback

Features in Detail

Automatic Caching

Generated content is automatically cached to improve performance:

{
  "job_title_channel_style": {
    "content": "Generated job description...",
    "timestamp": "2024-01-15T10:30:00"
  }
}

Responsive Design

• Mobile-friendly interface
• Adaptive layouts for all screen sizes
• Touch-optimized controls
• Readable typography on all devices

Dark Mode UI

• Eye-friendly dark theme
• Gradient accents for visual appeal
• High contrast for readability
• Modern, professional appearance

Troubleshooting

uvicorn main:app --reload --port 8001

pip install -r requirements.txt

Use Cases

Benefits

• Time Saving - Generate descriptions in seconds instead of hours
• Consistency - Maintain professional tone across all postings
• Optimization - AI-optimized content for each platform
• Flexibility - Easy customization and editing
• Assessment - Built-in candidate evaluation tools
• Cost-Effective - No need for external copywriting services

Future Enhancements

• Multi-language support
• Integration with job boards (LinkedIn, Indeed)
• Template library for common positions
• Collaborative editing features
• Analytics dashboard for job post performance
• Bulk generation for multiple positions
• Custom branding options
• Export to PDF/DOCX formats
• Advanced candidate scoring algorithms
• Interview question generation

Security & Privacy

• API keys stored securely in environment variables
• No sensitive data stored in cache
• HTTPS recommended for production
• Regular security updates

License

Educational and internal use

Powered by Google Gemini AI - Making recruitment smarter and faster