filament-calibrator
CLI tool suite for 3D printer filament calibration on Prusa printers.
Calibration Tools
- Temperature Tower — find the optimal printing temperature for a filament
- Extrusion Multiplier — measure wall thickness to calculate the correct extrusion multiplier
- Volumetric Flow — determine maximum volumetric flow rate for a filament/hotend combination
- Pressure Advance — find the optimal PA/Linear Advance value (tower or chevron pattern method)
- Retraction Test — find the optimal retraction distance by inspecting stringing between two towers
- Retraction Speed — find the optimal retraction speed (varies speed while keeping length fixed)
- Shrinkage Test — measure per-axis shrinkage (X/Y/Z) by printing a 3-axis calibration cross
- Tolerance Test — measure hole/peg dimensional accuracy with calipers
- Bridging Test — evaluate bridge quality at increasing span lengths
- Overhang Test — evaluate overhang quality at increasing angles (supports disabled)
- Cooling Test — find optimal fan speed by varying cooling at each height level
Quick Start
Install from PyPI (recommended on Python 3.10 or 3.12; requires PrusaSlicer on your PATH):
uv tool install "filament-calibrator[gui]" --python 3.12
Or download a standalone GUI binary from Releases — no Python needed.
Documentation
- Installation Guide — PyPI, standalone GUI, Windows, Raspberry Pi, conda, and source install options
- GUI User's Guide — walkthrough of the browser interface with screenshots
- Configuration — TOML config file for saving printer URL, API key, filament type, and other defaults
GUI
A browser-based GUI wraps all eleven tools:
filament-calibrator-gui
Development
pip install -e ".[dev]"
pytest tests/ --cov=src/filament_calibrator --cov-report=term-missing \
--cov-fail-under=100
100% statement coverage is enforced.
License
GPL-3.0-only
1 maintainer
Metadata
1 maintainer
Release files for filament-calibrator 0.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| filament_calibrator-0.4.0.tar.gz | 1.1 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| filament_calibrator-0.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.3 MB
Release files / filament_calibrator-0.4.0.tar.gz
| Download URL | filament_calibrator-0.4.0.tar.gz |
|---|---|
| Size | 1.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
610d25dab13ef57f5be14bbc2416fda823f40c4a4de5091891712a03b478fdad
|
|
BLAKE2b-256 checksum How to use checksums |
d7d426b74a60a92a4e59eb626d164d90a16e69224f2ffdd69d848763a4316460
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 20, 2026.
Transparency logRelease files / filament_calibrator-0.4.0-py3-none-any.whl
| Download URL | filament_calibrator-0.4.0-py3-none-any.whl |
|---|---|
| Size | 147.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
869217e9ad868695e74f41513382e476b96db1b78f9c2cfc78492696b3abdd18
|
|
BLAKE2b-256 checksum How to use checksums |
e590a99ff0e481b10636255738f173b6aea9986171cefeb07b13f3105693f36b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 20, 2026.
Transparency log
