Install & Compatibility
Where this runs
tested against v0.14.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.402s · 23.6MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 2.3s · import 0.374s · 24MB
22MB installed
● package 22MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
GotenbergClient
✓ from gotenberg_client import GotenbergClient
Main client class for synchronous usage.
AsyncGotenbergClient
✓ from gotenberg_client import AsyncGotenbergClient
Asynchronous client class.
PdfRoute
✓ from gotenberg_client import PdfRoute
Route for PDF conversions.
LibreOfficeRoute
✓ from gotenberg_client import LibreOfficeRoute
✗ from gotenberg_client.options import ...
Before v0.13.0, some routes were incorrectly placed in gotenberg_client.options.
Quickstart: Convert HTML to PDF using a local Gotenberg instance.
from gotenberg_client import GotenbergClient
client = GotenbergClient('http://localhost:3000')
with client:
pdf = client.pdf.convert_html('<html><body><p>Hello, World!</p></body></html>', filename='test.html')
with open('output.pdf', 'wb') as f:
f.write(pdf)
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'gotenberg_client.options'
Constants and options were moved from gotenberg_client.options to gotenberg_client.constants in v0.13.0.
fixUse 'from gotenberg_client.constants import ...' instead.
AttributeError: module 'gotenberg_client' has no attribute 'PdfRoute'
Likely using an older version or incorrect import. PdfRoute is available from the top-level module.
fixUse 'from gotenberg_client import PdfRoute'.
Upgrade
Version history
0.14.0latest on PyPI · released Mar 11, 2026
Audit
Dependencies
httpxrequiredHTTP client for API calls
pydanticrequiredData validation and settings management