Skip to main content

Typst-based CV/resume generator

Project description

RenderCV

The engine of the RenderCV App

test coverage docs pypi-version pypi-downloads

RenderCV engine is a Typst-based Python package with a command-line interface (CLI) that allows you to version-control your CV/resume as source code. It reads a CV written in a YAML file with Markdown syntax, converts it into a Typst code, and generates a PDF.

RenderCV engine's focus is to provide these three features:

  • Content-first approach: Users should be able to focus on the content instead of worrying about the formatting.
  • A mechanism to version-control a CV's content and design separately: The content and design of a CV are separate issues and they should be treated separately.
  • Robustness: A PDF should be delivered if there aren't any errors. If errors exist, they should be clearly explained along with solutions.

It takes a YAML file that looks like this:

cv:
  name: John Doe
  location: Location
  email: john.doe@example.com
  phone: tel:+1-609-999-9995
  social_networks:
    - network: LinkedIn
      username: john.doe
    - network: GitHub
      username: john.doe
  sections:
    welcome_to_RenderCV!:
      - '[RenderCV](https://rendercv.com) is a Typst-based CV
        framework designed for academics and engineers, with Markdown
        syntax support.'
      - Each section title is arbitrary. Each section contains
        a list of entries, and there are 7 different entry types
        to choose from.
    education:
      - institution: Stanford University
        area: Computer Science
        degree: PhD
        location: Stanford, CA, USA
        start_date: 2023-09
        end_date: present
        highlights:
          - Working on the optimization of autonomous vehicles
            in urban environments
    ...

Then, it produces one of these PDFs with its corresponding Typst file, Markdown file, HTML file, and images as PNGs. Click on the images below to preview PDF files.

Classic Theme Example of RenderCV Sb2nov Theme Example of RenderCV
Moderncv Theme Example of RenderCV Engineeringresumes Theme Example of RenderCV
Engineeringclassic Theme Example of RenderCV Custom themes can be added.

RenderCV comes with a JSON Schema so that the YAML input file can be filled out interactively.

JSON Schema of RenderCV

Getting Started

RenderCV engine is very easy to install (pip install "rendercv[full]") and easy to use (rendercv new "John Doe"). Follow the user guide to get started.

Motivation

We are developing a purpose-built app for writing CVs and resumes that will be available on mobile and web. This Python project is the foundation of that app. Check out our blog post to learn more about why one would use such an app.

Contributing

All contributions to RenderCV are welcome! To get started, please read the developer guide.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rendercv-2.0.tar.gz (8.0 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

rendercv-2.0-py3-none-any.whl (113.2 kB view details)

Uploaded Python 3

File details

Details for the file rendercv-2.0.tar.gz.

File metadata

  • Download URL: rendercv-2.0.tar.gz
  • Upload date:
  • Size: 8.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for rendercv-2.0.tar.gz
Algorithm Hash digest
SHA256 d91e855af647517938fee451f6b592829eff9a100e5889f54a5f6c5b6caec278
MD5 1f08f04499606f0c3e780c0521a452dd
BLAKE2b-256 435b21f2138b577f5f4316eff707de132a25f73edf017a3f9f52769772fc975d

See more details on using hashes here.

Provenance

The following attestation bundles were made for rendercv-2.0.tar.gz:

Publisher: publish-to-pypi.yaml on rendercv/rendercv

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file rendercv-2.0-py3-none-any.whl.

File metadata

  • Download URL: rendercv-2.0-py3-none-any.whl
  • Upload date:
  • Size: 113.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for rendercv-2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8841be33d1d7dfa7cb616edb71168f0633aed6783138ff547dda59a8de1d7f52
MD5 930d72819fd6d9375291e4d6557ebc48
BLAKE2b-256 f44c72e5d69b6e8d2d7c5dd95f24b6c781375f12f3d03a643dc152d48d25e6f7

See more details on using hashes here.

Provenance

The following attestation bundles were made for rendercv-2.0-py3-none-any.whl:

Publisher: publish-to-pypi.yaml on rendercv/rendercv

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page