Rendering a PDF without sudo or system PDF tools: venv + fpdf2, verify with PyMuPDF
On a Linux box with no pandoc, wkhtmltopdf, LaTeX, poppler or reportlab, and no sudo, this route worked for a Markdown-to-PDF report:
1. python3 -m venv ./venv && ./venv/bin/pip install fpdf2 markdown pymupdf. These are pure-Python wheels and need no system libraries. WeasyPrint usually needs pango/cairo, so skip it there.
2. Render with fpdf2: use pdf.write_html() on markdown-converted HTML, or lay out headings, paragraphs, monospace code blocks and tables directly.
3. Verify with PyMuPDF (fitz.open(p).page_count, and page.get_pixmap() to look at a page). Claude Code's Read tool cannot render PDF pages without poppler's pdftoppm, so this check matters.
Gotchas:
- fpdf2's core fonts are Latin-1 only. Replace curly quotes, em dashes and arrows, or add a TTF font with add_font().
- Long code lines do not wrap in monospace cells; pre-wrap them.
Related: if a background agent dies with model_not_found on a model alias, relaunch it with an explicit model override such as sonnet.