Resume Builder

A LaTeX-based automated system for maintaining multiple versions of your resume with different project combinations. This tool solves a common problem in job applications: the need to customize your resume for different positions while keeping the content consistent and professional.

Example Output

Here's a sample of what the generated resume looks like:

The tool generates multiple versions of this resume with different project combinations. For example, if you have three projects:

• Optimization For Machine Learning
• Pricing of Some Exotic Options
• EPFLLaMA (LLM Project)

It will generate:

• output/Optimization_Pricing/YourName.pdf
• output/Optimization_LLM/YourName.pdf
• output/Pricing_LLM/YourName.pdf
• output/Optimization_Pricing_LLM/YourName.pdf

Why Use This?

When applying for different positions, you often want to highlight different projects based on their relevance to each role. For example:

• A machine learning position might need your ML projects
• A web development role might need your full-stack projects
• A research position might need your academic projects

Maintaining multiple versions of your resume manually can be tedious and error-prone. If you update one section (like your work experience or skills), you need to update it across all versions. This tool automates that process by:

1. Keeping your core information (education, experience, skills) in a single template
2. Storing each project as a separate file
3. Automatically generating all possible combinations of your projects
4. Building professional PDFs using LaTeX
5. Using GitHub Actions to automate the build process

This way, you can focus on writing great content while the tool handles the tedious work of maintaining multiple resume versions.

🌟 Features

• Automatically generates multiple PDF resumes with different project combinations
• Supports both combinations and permutations modes
• Supports customizable subset sizes (1-N projects) for combinations/permutations
• Uses LaTeX for professional-looking documents
• Automated builds via GitHub Actions
• Easy project management through simple LaTeX files

🚀 Getting Started

Prerequisites

• Git
• GitHub account
• LaTeX installation (for local builds)
• Python 3.x (for local builds)

Setup Instructions

1. Fork this repository:

   • Click the "Fork" button at the top right of this repository
   • Choose your account as the destination
   • If you want to protect your personal information, select "Private" for repository visibility

2. Clone your forked repository:

   git clone https://github.com/yourusername/Resume-Builder.git
   cd Resume-Builder

3. Set up GitHub Actions:

   • Go to your repository settings on GitHub
   • Navigate to Actions > General
   • Under "Workflow permissions", select "Read and write permissions"
   • Save the changes

4. Customize the template:

   • Edit template.tex with your personal information
   • Replace the details in the header (name, contact info, etc.)
   • Update the Education and Experience sections
   • Modify the Skills section as needed

5. Add your projects:

   • Create a new .tex file for each project in the projects/ directory
   • Follow the format shown in the example LLM.tex
   • Each project file should contain a single rSubsection environment

6. Commit and push your changes:

   git add .
   git commit -m "Update resume content"
   git push

7. GitHub Actions will automatically:

   • Build all PDF combinations
   • Commit them to the output/ directory
   • Push the changes back to your repository

8. Pull the generated PDFs:

   git pull

Staying Updated with the Original Template

To get updates from the original template repository:

1. Add the original repository as upstream:

   git remote add upstream https://github.com/original-author/Resume-Builder.git

2. Whenever you want to pull updates:

   git fetch upstream
   git merge upstream/main

Important Notes

• Consider making your fork private to protect personal information
• The first GitHub Actions workflow may need manual approval in your repository's Actions tab
• You can use [skip ci] in your commit message to prevent PDF generation
• Make sure to grant write permissions to GitHub Actions as described in step 3

📁 Repository Structure

Resume-Builder/
├── .github/workflows/
│   └── build.yml         # GitHub Actions workflow
├── projects/
│   ├── LLM.tex          # Example project
│   └── *.tex            # Your project files
├── output/              # Generated PDFs
├── template.tex         # Main resume template
├── resume.cls          # LaTeX class file
└── build.py            # Build script

🛠️ Configuration

Build Modes

The builder supports customizable project ranges:

• Combinations: Generates PDFs for unique project groups (order doesn’t matter)
• Permutations: Generates PDFs for every project order (order matters)

Examples with --min-projects=1 --max-projects=3:

• For projects A, B, C:

  • Combinations (--mode combinations):

    • 1-project: A.pdf, B.pdf, C.pdf
    • 2-project: AB.pdf, AC.pdf, BC.pdf
    • 3-project: ABC.pdf

  • Permutations (--mode permutations):

    • 1-project: A.pdf, B.pdf, C.pdf
    • 2-project: AB.pdf, BA.pdf, AC.pdf, CA.pdf, BC.pdf, CB.pdf
    • 3-project: ABC.pdf, ACB.pdf, BAC.pdf, BCA.pdf, CAB.pdf, CBA.pdf

GitHub Actions Configuration

The build mode and PDF name can be configured in .github/workflows/build.yml:

 pre_compile: |
   MODE="permutations"      # "combinations" or "permutations"
   PDF_NAME="AliBakly.pdf"  # rename as needed
   MIN_PROJECTS=1           # minimum number of projects in a resume
   MAX_PROJECTS=3           # maximum number of projects in a resume

Local Building

To build locally:

python build.py --mode combinations --pdf_name YourName.pdf --min-projects 1 --max-projects 4

💡 Tips

• Use [skip ci] in your commit message to prevent GitHub Actions from building PDFs
• Pull after each build to get the latest PDFs

📝 Project File Format

Each project file in the projects/ directory should be a .tex file containing a single project section. Here's an example from one of the sample projects:

\begin{rSubsection}
{\href{https://github.com/YourUsername/Project}{\underline{Optimization For Machine Learning} \href{Project Link}{\raisebox{-0.1\height}\faExternalLink }}}{}{}{}

\item Formulated and implemented cutting-edge optimization algorithms, including Fast Iterative Shrinkage Thresholding Algorithm (FISTA) and Adaptive Proximal Gradient Method(AdProxGD).
\item Conducted in-depth analysis of convergence guarantees and empirical performance of optimization methods.
\item Explored the Power Method for constrained quadratic maximization problems.
\item Applied Mirror Descent algorithms to optimization over the unit simplex.
\item Developed modular, reproducible Python-based implementations for optimization tasks.
\end{rSubsection}
\vspace{-8pt}  % Optional spacing adjustment

Key points about project files:

• Save each project as a separate .tex file in the projects/ directory
• Format bullet points using \item
• Use LaTeX formatting for emphasis where needed (e.g., \textbf{Python})

🤝 Contributing

Feel free to submit issues and enhancement requests!