A fast, reliable REST API for generating professional resumes from JSON data. Built on the popular Jake's Resume LaTeX template, ResumeTex eliminates the complexity of LaTeX while maintaining the professional quality output.

• Multiple Output Formats: Generate PDF, LaTeX (.tex), or plain text
• RESTful API: Simple HTTP endpoints for easy integration
• Customizable Fonts: Support for multiple LaTeX font families
• Flexible Schema: Comprehensive JSON structure supporting education, experience, projects, skills, and more
• Docker Ready: Containerized deployment with all LaTeX dependencies
• Web Interface: Interactive HTML frontend for quick testing
• Production Ready: Built with FastAPI for high performance

1. FastAPI Server (server.py): Handles HTTP requests and routing
2. Resume Maker (resume/resume_maker.py): Orchestrates resume generation
3. Resume Class (resume/resume.py): Core LaTeX template and formatting logic
4. Web Interface (public/): HTML frontend with interactive tools

1. Client sends JSON resume data via POST request
2. FastAPI validates and routes the request
3. ResumeMaker processes the data and generates LaTeX
4. For PDFs: LaTeX is compiled using pdflatex in a temporary directory
5. Response is returned in the requested format (PDF download, TEX file, or text)
6. Temporary files are cleaned up automatically

• Python 3.13+
• pdflatex (for PDF generation)
• Docker (optional, for containerized deployment)

1. Clone the repository

   git clone https://github.com/anish-sahoo/ResumeTex.git
   cd ResumeTex

2. Install dependencies

   pip install -r requirements.txt

3. Install LaTeX (Ubuntu/Debian)

   sudo apt-get update && sudo apt-get install -y \
       texlive-latex-base \
       texlive-fonts-recommended \
       texlive-fonts-extra \
       texlive-latex-extra

4. Run the server

   uvicorn server:app --reload --host 0.0.0.0 --port 8000

5. Access the application

   • Web Interface: http://localhost:8000
   • API Documentation: http://localhost:8000/documentation

1. Build the image

   docker build -t resumetex .

2. Run the container

   docker run -p 8000:8000 resumetex

The application will be available at http://localhost:8000.

For production deployments with automatic updates, you can use the included deployment script:

Usage:

1. Make the script executable: chmod +x update.sh
2. Run the script: ./update.sh

This script will automatically:

• Stop and remove any existing container
• Pull the latest code from Git
• Rebuild the Docker image
• Start a new container with the updated code

Visit the homepage and use the interactive form to generate resumes instantly.

Generate PDF:

curl -X POST -H "Content-Type: application/json" \
  -d @resume.json \
  https://resumetex.asahoo.dev/api/v1/pdf \
  --output resume.pdf

Generate LaTeX file:

curl -X POST -H "Content-Type: application/json" \
  -d @resume.json \
  https://resumetex.asahoo.dev/api/v1/tex \
  --output resume.tex

Get LaTeX as text:

curl -X POST -H "Content-Type: application/json" \
  -d @resume.json \
  https://resumetex.asahoo.dev/api/v1/text

import requests
import json

# Your resume data
resume_data = {
    "name": "Your Name",
    "email": "your.email@example.com",
    "phone": "123-456-7890",
    # ... rest of your resume data
}

# Generate PDF
response = requests.post(
    'https://resumetex.asahoo.dev/api/v1/pdf',
    json=resume_data
)

if response.status_code == 200:
    with open('resume.pdf', 'wb') as f:
        f.write(response.content)
    print("Resume generated successfully!")
else:
    print(f"Error: {response.status_code}")

The API accepts a flexible JSON structure. All fields except name are optional.

{
  "name": "Your Name",
  "phone": "123-456-7890",
  "email": "your.email@example.com",
  "font": "fira",
  "font_size": 12,
  "links": [...],
  "education": [...],
  "experience": [...],
  "projects": [...],
  "skills": [...],
  "interests": [...],
  "page_break": true
}

• fira - Fira Sans (default)
• roboto - Roboto
• noto-sans - Noto Sans
• sourcesanspro - Source Sans Pro
• cormorantgaramond - Cormorant Garamond
• charter - Charter

{
  "name": "Anish Sahoo",
  "phone": "123-456-7890",
  "email": "anish@email.email",
  "font": "fira",
  "font_size": 12,
  "links": [
    {
      "url": "https://www.linkedin.com/in/anish-sahoo",
      "text": "linkedin.com/in/anish-sahoo"
    },
    {
      "url": "https://asahoo.dev",
      "text": "asahoo.dev"
    }
  ],
  "education": [
    {
      "school": "Northeastern University",
      "time": "Expected Graduation: December 2026",
      "degree": "Bachelor of Science in Computer Science",
      "location": "Boston, MA",
      "details": [
        "Major GPA: 3.95",
        "Coursework: Machine Learning, Artificial Intelligence"
      ]
    }
  ],
  "experience": [
    {
      "company": "Tech Solutions Inc.",
      "jobs": [
        {
          "time": "June 2021 - August 2021",
          "title": "Software Engineer Intern",
          "location": "Boston, MA",
          "details": [
            "Developed a web application to manage data",
            "Implemented a feature to allow users to upload files"
          ]
        }
      ]
    }
  ],
  "projects": [
    {
      "title": "Personal Portfolio",
      "subtitle": "A personal website to showcase my projects and skills",
      "time": "January 2021 - Present",
      "details": [
        "Built using HTML, CSS, and JavaScript",
        "Includes a blog section where I write about my learning experiences"
      ]
    }
  ],
  "interests": [
    "Reading",
    "Traveling",
    "Photography",
    "Coding"
  ],
  "skills": [
    {
      "title": "Programming Languages",
      "items": [
        "Python",
        "Java",
        "C++"
      ]
    },
    {
      "title": "Web Development",
      "items": [
        "HTML",
        "CSS",
        "JavaScript"
      ]
    }
  ]
}

• FastAPI: Modern, fast web framework for building APIs
• Uvicorn: ASGI server for FastAPI
• Pydantic: Data validation using Python type hints
• LaTeX: Document preparation system for high-quality typesetting

ResumeTex/
├── server.py               # FastAPI application and routes
├── requirements.txt        # Python dependencies
├── Dockerfile              # Container configuration
├── sample_input.json       # Example resume data
├── public/                 # Web interface assets
│   ├── index.html          # Main web interface
│   └── documentation.html  # API documentation
├── resume/                 # Core resume generation logic
│   ├── __init__.py
│   ├── resume_maker.py     # Main resume orchestrator
│   └── resume.py           # LaTeX template and formatting
└── tests/                  # Test files and examples
    ├── sample_input_bad_col.json
    └── sample_input_pagebreak.json

• Temporary File Management: PDF generation creates temporary directories that are automatically cleaned up
• Background Tasks: Cleanup operations run asynchronously to avoid blocking responses
• Memory Efficiency: LaTeX compilation is isolated to prevent memory leaks
• Error Handling: Comprehensive error handling for LaTeX compilation failures

1. LaTeX Compilation Errors

   • Ensure all required LaTeX packages are installed
   • Check for special characters that need escaping
   • Verify JSON structure matches the expected schema

2. Font Issues

   • Verify the font name is supported (see Supported Fonts section)
   • Font packages must be available in your LaTeX installation

3. Permission Errors

   • Ensure the application has write permissions for temporary directories
   • Check that pdflatex is in the system PATH

Enable debug logging by setting environment variables:

export PYTHONPATH=/path/to/ResumeTex
export DEBUG=1
uvicorn server:app --reload --log-level debug

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

# Install development dependencies
pip install -r requirements.txt

# Run tests
python -m pytest tests/

# Run server
fastapi run server.py

This project is licensed under the MIT License - see the LICENSE file for details.

• Production: resumetex.asahoo.dev
• Documentation: resumetex.asahoo.dev/documentation
• Issues: GitHub Issues
• Author: Anish Sahoo

Made with love by Anish Sahoo