---
id: typst
version: "0.15.0"
license: unclear
license_treatment: unclear
maintenance: active
---

# typst — Python binding to Typst, a new markup-based typesetting system that is powerful and easy to learn.

License: unclear · Maintenance: active · Downloads: 474.3K/mo

## What it is and what it does

typst is a Python binding to the Typst typesetting system, allowing you to compile Typst markup documents programmatically from Python. It wraps the Typst compiler as a native extension, exposing functions to convert `.typ` files to PDF, PNG, SVG, or HTML output formats. The package supports single-file and multi-file projects, reproducible builds via fixed timestamps, query and eval operations for introspection, and passing runtime values into documents via `sys_inputs`.

The binding is implemented in Rust with stable ABI wheels (cp38-abi3) covering Python 3.8 through 3.14 on major platforms. It has no Python runtime dependencies, making it lightweight to deploy. Recent maintenance (last commit 2026-08-01, version 0.15.0 released 2026-06-16) and active status suggest ongoing development, though the license treatment remains unclear in the metadata.

Use it for:

- Generate PDFs or images from Typst templates in a web service or batch processing pipeline
- Embed Typst compilation into a Python documentation or report generation tool
- Build multi-file Typst projects programmatically by passing file dictionaries and package paths
- Query or evaluate Typst expressions to extract structured data from compiled documents
- Create reproducible document builds by fixing timestamps and controlling package caching

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Compiles Typst markup documents to PDF, PNG, SVG, and HTML directly from Python, with support for multi-file projects and programmatic value passing.

Yes, with a license caveat. The package is actively maintained, has no runtime dependencies, and offers a clean Python API to a powerful typesetting system. Install friction is moderate due to compiled wheels, but prebuilt binaries cover most platforms. Before production use, clarify the actual license terms—the metadata provides no SPDX identifier or raw license text, only an 'unclear' classification.

## Install

pip install typst
uv add typst
poetry add typst

## Installing typst

Before you install: Medium install friction due to compiled wheels for multiple platforms and Python versions (cp38-abi3 through cp314t). Active maintenance with recent release and repository activity. No runtime dependencies simplifies deployment.

License in practice: License treatment is unclear—no SPDX identifier or raw license text provided in metadata. Verify the actual license terms before use, particularly if integrating into proprietary or GPL-licensed projects.

Quickstart:

import typst

# Compile Typst file to PDF
pdf_bytes = typst.compile("hello.typ")

# Or compile to PNG with custom resolution
images = typst.compile("hello.typ", output="hello{n}.png", format="png", ppi=144.0)

# Use Compiler class for repeated operations
compiler = typst.Compiler()
compiler.compile(input="hello.typ", format="svg")

Verify before relying:

- Actual license identifier and terms (metadata shows unclear treatment with no SPDX or raw license provided)
- Whether compiled output (PDF, PNG, SVG) inherits any licensing constraints from Typst itself
- Performance characteristics and memory usage for large or complex documents

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 474.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

typst document compilation python, markup to pdf converter, typst python binding, document generation typesetting, typst cli python wrapper, compile markup to image, typst query eval python, document-generation, typesetting, rust-binding

[View on SkillFed](https://skillfed.io/packages/typst) · [View on PyPI](https://pypi.org/project/typst/)