Installation

Prerequisites

Python

Python ≥ 3.11 is required.

Quarto

Install Quarto for your platform. quarto-coursegen generate only writes plain .qmd files and does not invoke Quarto, but you will need it for the rendering stage.

Quarto extensions

The built-in .qmd.j2 templates reference the fontawesome extension. Install it once per course project after running quarto-coursegen init:

quarto add quarto-ext/fontawesome

Installing quarto-coursegen

Via pip

pip install quarto-coursegen

Via uv (recommended)

uv installs quarto-coursegen as an isolated CLI tool, available globally without activating a virtual environment:

uv tool install quarto-coursegen

To update later:

uv tool upgrade quarto-coursegen

Verify the installation

quarto-coursegen --version

Python virtual environments

If you prefer a project-local install, create a virtual environment first:

python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install quarto-coursegen

Upgrading

pip install --upgrade quarto-coursegen
# or
uv tool upgrade quarto-coursegen