resumake

Build styled CV documents from a single YAML source.

resumake turns a cv.yaml file into polished Word (.docx) documents with a two-column layout, photo, icons, and consistent theming. Translate to any language, tailor for a specific job, generate a cover letter, or export to Markdown/HTML/JSON — all from the command line.

Quickstart

# Install
uv tool install resumakeai

# Scaffold a new project
resumake init my-cv
cd my-cv

# Edit cv.yaml with your information, then build
resumake build --lang en

Installation

With uv (recommended):

uv tool install resumakeai                      # Core (YAML -> Word)
uv tool install resumakeai --with anthropic     # + AI (Anthropic Claude)
uv tool install resumakeai --with openai        # + AI (OpenAI / compatible)
uv tool install "resumakeai[all]"               # Everything

With pip:

pip install resumakeai              # Core
pip install "resumakeai[anthropic]" # + Anthropic Claude
pip install "resumakeai[openai]"    # + OpenAI / compatible
pip install "resumakeai[all]"       # Everything

Optional extras

Features

• YAML-first — single source of truth for all your CV data
• Styled Word output — two-column layout with sidebar, photo, icons, clickable links, and professional typography
• Themes — six built-in themes (classic, minimal, modern, single-column, academic, compact) or bring your own via YAML
• Template variants — two-column (default), single-column, academic (publications first), and compact layouts
• Custom sections — define arbitrary sections (awards, patents, projects) in cv.yaml as top-level lists
• Multilingual — translate to any language via AI, with per-language caching and auto-invalidation
• Tailor — reorder and emphasize experience for a specific job description, with batch mode
• Cover letter — AI-generated cover letter matched to a job description
• Bio — generate a condensed one-pager bio document
• Content suggestions — AI-powered bullet improvements and CV optimization advice
• ATS keyword optimization — keyword match scoring against job descriptions
• Export — convert to Markdown, HTML, JSON, ATS-friendly plain text, or JSON Resume
• Import — import from JSON Resume or LinkedIn PDF exports
• Preview — instant HTML preview in your browser, with live auto-reload
• Diff — compare two CV YAML files side by side
• Validate — check your YAML against the schema before building, with photo validation
• Config file — persistent build defaults via .resumakerc.yaml
• Watch mode — auto-rebuild on file changes
• PDF export — via WeasyPrint (HTML-based) or docx2pdf (Word-based)
• Web UI — interactive browser-based editor with live preview, AI tools, import, and LLM settings (resumake web)
• Offline by default — core build requires no API keys or network access

Commands

resumake build

Build CV documents from YAML source.

resumake build                        # English only (default)
resumake build --lang en,de           # English + German
resumake build --lang fr              # French (any language code works)
resumake build --lang en,fr,de        # Multiple languages at once
resumake build --theme minimal        # Use a different theme
resumake build --pdf                  # Also generate PDF
resumake build --pdf --pdf-engine weasyprint  # PDF via WeasyPrint (no Word needed)
resumake build --no-open              # Don't auto-open the files
resumake build --watch                # Auto-rebuild on changes
resumake build --cache                # Reuse cached translations (default: always re-translate)

resumake tailor

Produce a tailored CV variant for a specific job description. Requires AI.

resumake tailor job-description.txt
resumake tailor job-description.txt --lang de --pdf
resumake tailor --batch jobs/         # Batch: one tailored CV per .txt/.md file in directory

resumake cover

Generate a cover letter matching your CV to a job description. Requires AI.

resumake cover job-description.txt
resumake cover job-description.txt --lang fr --pdf --theme modern

resumake bio

Generate a condensed one-pager bio document.

resumake bio                          # Uses AI if available, else deterministic
resumake bio --lang de --pdf

resumake export

Export your CV to Markdown, HTML, JSON, or ATS-friendly plain text.

resumake export md                    # Markdown
resumake export html                  # Styled, themed HTML page
resumake export json                  # Raw JSON
resumake export txt                   # ATS-friendly plain text
resumake export jsonresume            # JSON Resume format
resumake export md -o resume.md       # Custom output path

resumake import

Import a CV from an external format.

resumake import jsonresume resume.json          # From JSON Resume
resumake import jsonresume resume.json -o cv.yaml
resumake import linkedin profile.pdf            # From LinkedIn PDF export (requires AI)

resumake suggest

AI-powered CV content improvement suggestions. Requires AI.

resumake suggest
resumake suggest --source custom-cv.yaml

resumake ats

ATS keyword match analysis between your CV and a job description. Requires AI.

resumake ats job-description.txt
resumake ats job-description.txt --source custom-cv.yaml

resumake web

Launch an interactive web UI for editing and previewing your CV in the browser. Includes visual YAML editing, live preview, AI tools (tailor, cover letter, ATS, suggestions, bio), import, and LLM provider settings.

resumake web                          # Start on http://127.0.0.1:3000 (auto-opens browser)
resumake web --port 8080              # Custom port
resumake web --host 0.0.0.0           # Listen on all interfaces
resumake web --no-open                # Don't auto-open browser
resumake web my-cv/                   # Use a specific project directory

resumake preview

Generate an HTML preview and open it in your browser.

resumake preview                      # One-shot preview
resumake preview --theme modern       # With a specific theme
resumake preview --live               # Live-reloading server
resumake preview --live --port 3000   # Custom port

resumake diff

Compare two CV YAML files and show what changed.

resumake diff cv.yaml cv_tailored.yaml

resumake themes

List available built-in themes with color previews.

resumake themes

resumake validate

Check your CV YAML against the schema.

resumake validate

resumake init

Scaffold a new resumake project with an example CV and icons.

resumake init                         # In current directory
resumake init my-cv                   # In a new directory

Global options

resumake --version                    # Show version
resumake --help                       # Show help

Config File

Create a .resumakerc.yaml in your project directory (or ~/.resumakerc.yaml for global defaults) to avoid repeating CLI options:

lang: "en,de"
theme: "modern"
pdf: true
open: true
source: "cv.yaml"
watch: false

Project-level config overrides user-level. CLI flags always take priority over both.

CV YAML Structure

name: "Jane Doe"
title: "Senior Software Engineer"
photo: "profile.jpeg"

contact:
  address: "Berlin, Germany"
  phone: "+49 123 456 7890"
  email: "jane.doe@example.com"
  nationality: "German"

links:
  - label: "LinkedIn"
    url: "https://linkedin.com/in/janedoe"
  - label: "GitHub"
    url: "https://github.com/janedoe"

skills:
  leadership: ["Team Leadership", "Agile Coaching"]
  technical: ["Python", "TypeScript", "React"]
  languages:
    - name: "English"
      level: "fluent"     # native | fluent | professional | basic

profile: >
  Senior Software Engineer with 8+ years of experience...

experience:
  - title: "Senior Software Engineer"
    org: "TechCorp GmbH"
    start: "March 2021"
    end: "Present"
    description: "Leading backend development for a SaaS platform."
    bullets:
      - "Architected a microservices migration reducing deployment time by 60%"
    tech_stack: ["Python", "FastAPI", "PostgreSQL"]

education:
  - degree: "M.Sc. Computer Science"
    institution: "Technical University of Berlin"
    start: "2014"
    end: "2016"

Experience entries accept arbitrary extra fields (e.g. tech_stack, soft_skills, project_methodology) which are rendered as labeled metadata below the bullets.

Run resumake init to get a complete example with all supported sections including testimonials, certifications, publications, volunteering, and references.

Themes

resumake ships with three built-in themes:

resumake build --theme modern
resumake themes                       # List all themes with color swatches

Custom themes

Create a theme.yaml in your project directory (auto-detected) or pass a path:

name: my-theme
colors:
  primary: "1A1A2E"       # Sidebar background
  accent: "E94560"        # Links, dividers, labels
  text_light: "EAEAEA"    # Sidebar text
  text_muted: "9A9ABF"    # Secondary text (dates, labels)
  text_body: "1A1A2E"     # Main body text
fonts:
  heading: "Calibri"
  body: "Calibri"
layout:
  sidebar_width_cm: 5.5
  main_width_cm: 12.5
sizes:
  name_pt: 15
  heading_pt: 13
  body_pt: 9

AI Features

AI-powered features work with multiple LLM providers. Install the one you prefer and set an API key:

Anthropic Claude:

uv tool install resumakeai --with anthropic
export ANTHROPIC_API_KEY=your-key-here

OpenAI:

uv tool install resumakeai --with openai
export OPENAI_API_KEY=your-key-here

OpenAI-compatible APIs (Ollama, LiteLLM, Azure, etc.):

export OPENAI_API_KEY=your-key
export OPENAI_BASE_URL=http://localhost:11434/v1   # e.g. Ollama
export OPENAI_MODEL=llama3                          # optional, defaults to gpt-4o

The provider is auto-detected from environment variables (checked in order: ANTHROPIC_API_KEY, OPENAI_API_KEY).

Translations are cached per language (e.g. output/.cv_de_cache.yaml, output/.cv_fr_cache.yaml). The cache auto-invalidates when your source cv.yaml changes, and incomplete translations are automatically detected and re-triggered.

See PRIVACY.md for details on what data is sent and when.

Changelog

See CHANGELOG.md for release history.

Development

git clone https://github.com/fayssal-elmofatiche/resumake.git
cd resumake
uv sync --all-extras
uv run pytest
uv run ruff check .

See CONTRIBUTING.md for more details.

License

MIT