Skip to content

Install Fullbleed for Python

Current stable Fullbleed supports standard-GIL CPython 3.10–3.15. Published wheels cover Windows, macOS, and Linux, including the architectures listed below.

python -m pip install fullbleed
python -m fullbleed --version
python -m fullbleed doctor --strict --json

Use python3 if that is your Python command. The wheel bundles the engine and fonts; the core package has no required third-party Python runtime dependencies.

Use a virtual environment

python -m venv .venv

On Windows PowerShell:

.venv\Scripts\Activate.ps1
python -m pip install fullbleed

On macOS or Linux:

source .venv/bin/activate
python -m pip install fullbleed

Published platforms

Platform Wheel targets
Windows x86-64, x86, ARM64
macOS Intel, Apple silicon
Linux, manylinux2014 x86-64, x86, ARM64, ARMv7, s390x, ppc64le
Linux, musllinux 1.2 x86-64, x86, ARM64, ARMv7

The stable-ABI wheels cover supported CPython versions. For an unsupported target, a source build requires Rust; source build instructions are in the engine repository.

Python 3.15 final

The retained Fullbleed 2.5.34 qualification checks its public wheel on CPython 3.15.0 final on Windows x64, Linux x64, and Intel and Apple-silicon Macs. Use the ordinary installation command above.

Each platform's job verifies the PyPI wheel and matching release source, runs the complete Python suite and isolated API/CLI checks, and compares generated PDFs and previews byte for byte with the same wheel on Python 3.10. The Linux job also checks installation in the official python:3.15-slim container with networking disabled.

The coverage note and retained evidence describe the exact checks and the explicit skip for an unavailable legacy subinterpreter API. This qualification covers standard-GIL builds; free-threaded builds and subinterpreters remain outside its scope.

The earlier rc3 checks remain available as historical evidence.

Run in Docker

The Docker invoice starter includes a FastAPI app, editable HTML/CSS, bundled fonts, and a Dockerfile tested on Debian slim and Alpine on x64 and ARM64. It installs wheels with --only-binary=:all: and runs as a non-root user with a read-only filesystem. Use it to check your container integration before adapting the renderer to your application.

Troubleshooting

Symptom Next step
fullbleed command is not found Use python -m fullbleed from the environment where you installed it.
pip starts a Rust build Upgrade pip and check that your Python/platform has a published wheel. Use --only-binary=:all: to require one; the Docker starter demonstrates this in slim and Alpine images.
Permission or externally managed environment error Install inside a virtual environment.
Missing characters Register a font containing those characters; see fonts and assets.

Create your first PDF →