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¶
On Windows PowerShell:
On macOS or Linux:
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. |