Resume Enhance is an open-source resume builder designed to help you create professional, high-impact resumes. It simplifies the process of crafting clear and effective content.
You can import an existing resume or start from scratch. The application provides smart feedback to refine your bullet points using the STAR method (Situation, Task, Action, Result), ensuring your achievements are presented clearly. Once done, you can export your resume as a high-quality PDF.
- Smart Enhancement: Automatically restructure your experience using the STAR format for maximum impact.
- Resume Dashboard: Manage multiple resumes, duplicate specific versions, or delete old ones.
- PDF Import: Upload your existing LinkedIn PDF resume to get started immediately.
- Live Preview: See how your resume looks in real-time before exporting.
- PDF Export: Download a professional, ATS-friendly PDF (currently supports FaangPath template).
- User Accounts: Sign up, log in, and save your work securely.
Here is what the application looks like:
Manage all your resumes in one place.
Edit your details and use AI to enhance your texts.
Check the final layout instantly.
Get the final PDF document.
You can run this project using Docker (recommended) or manually in your terminal.
- OpenAI API Key: You need a key to use the AI features.
- Docker: For the easiest setup.
- Python 3.10+ & PostgreSQL: If running manually.
git clone https://github.com/koksalkapucuoglu/resume-enhance.git
cd resume-enhanceCreate your .env file by copying the template:
cp .env.example .envOpen .env and update the values:
| Variable | Description | Example |
|---|---|---|
OPENAI_API_KEY |
API key from OpenAI | sk-proj-... |
DEBUG |
Django debug mode | True (dev) or False (prod) |
SECRET_KEY |
Django secret key | Auto-generated for dev |
ALLOWED_HOSTS |
Allowed domain list | localhost,127.0.0.1 |
POSTGRES_DB |
Database name | postgres |
POSTGRES_USER |
Database user | postgres |
POSTGRES_PASSWORD |
Database password | postgres (change in prod) |
EMAIL_HOST_USER |
SMTP email | your_email@gmail.com |
EMAIL_HOST_PASSWORD |
SMTP password | App password (not account password) |
For production, use .env.prod.example as your template and set DEBUG=False.
This serves both the app and the database automatically.
# Build the project
make build
# Run the project
make runThe app will be available at http://localhost:8000.
To stop the app:
make downIf you prefer running without Docker, you need to have PostgreSQL running locally.
-
Create and Activate Virtual Environment
python3 -m venv venv source venv/bin/activate -
Install Dependencies
pip install -r requirements.txt
-
Run Migrations Make sure your
DATABASE_URLin.envpoints to your local Postgres database.python manage.py migrate
-
Run the Server
python manage.py runserver
Visit http://127.0.0.1:8000.
We have migrated from Fly.io to a self-hosted setup on Hetzner Cloud (or any VPS) using Docker Compose.
👉 Read the Complete Deployment Guide
This guide covers:
- Provisioning a cheap & powerful server (Ubuntu 24.04).
- Setting up Security (Firewall, SSH).
- Configuring DNS (
yourdomain.com). - Deploying with Docker Compose & Caddy (Automatic SSL).
- Setting up GitHub Actions for automatic deployment.
We are constantly improving Resume Enhance. Here is what's coming next:
- Template Selection: Choose from multiple resume designs (not just FaangPath).
- Parsing V2: Better import quality for existing PDFs using newer AI models.
- Direct Download: Download PDFs directly from the dashboard card.
- Feedback Loop: A built-in form to report bugs or request features.
- Multi-language Support: Support for Turkish and English interfaces.
- Rate Limiting: Better protection against API abuse.
Open Source.