Unoriginal Prusa Connect Python Client

Control your Prusa 3D printers programmatically with Python. This library provides a frictionless, strongly-typed interface for the Prusa Connect API.

[!WARNING] A Note on Unoriginal-ness

This SDK is not an officially supported or endorsed product of Prusa Research. It is developed and maintained by an independent developer and is not affiliated with Prusa Research. See Motivation & Design for more information.

Features:

• Zero-Config Authentication: Log in once via CLI, use everywhere in Python.
• Strong Typing: Full Pydantic models for printers, jobs, cameras, and files.
• Batteries Included: Retries, timeouts, and error handling out of the box.
• CLI Tool: Manage printers from the terminal with prusactl.

Installation

Install the package with the CLI tools (recommended for easiest setup):

pip install "prusa-connect-sdk-client[cli]"

Or install the lightweight library only:

pip install prusa-connect-sdk-client

Quick Start

from prusa.connect.client import PrusaConnectClient

# Credentials are automatically loaded from the CLI session
# (run `prusactl auth login` first)
client = PrusaConnectClient()

for printer in client.printers.list_printers():
    status = printer.printer_state or "UNKNOWN"
    print(f"- {printer.name} ({status})")

Resources are grouped by service — client.printers, client.cameras, client.teams, client.files, client.jobs, and client.stats.

Documentation

Full documentation including the CLI reference, SDK quickstart, and API reference is available at:

https://dcode.github.io/python-prusa-connect-sdk-client/

Motivation and Design

My motivation to create this library is to provide a frictionless, strongly-typed interface for the Prusa Connect API. I want to be able to monitor and control my Prusa 3D printers programmatically with Python. I love building tools, which has led to me loving my Prusa 3D printers.

It is my goal that this library has the same level of quality engineering and "feel" as the products Prusa Research produces. That goal drove the decisions on library layout (e.g. prusa.connect.client namespace) and the naming of the PyPI package itself.

That said, if anyone from Prusa Research wishes to take over development of this library, I would be happy to hand it over (and keep contributing, if desired). Alternatively, I can keep this project going as a community-driven project in my spare time. If you're from Prusa Research and wish to support this work, I'd gladly accept Prusameters towards a new Core-generation printer. 😉

My Printables Profile: :simple-printables: dcode

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for development setup, testing, and pull request guidelines.

License

This project is licensed under the GNU Affero General Public License v3.0 or later.