fleetq

A local, self-hosted print queue + fleet manager for Prusa printers, and an OSS PrusaConnect replacement that never leaves your LAN.

Two halves, both implemented against open documentation/source — no reverse engineering:

• Pull mode — fleetq drives each printer's local PrusaLink /api/v1 API: upload g-code, start/pause/stop, telemetry, multi-printer dispatch with nozzle/material matching.
• Push mode — fleetq runs a local Connect server so printers can "phone home" to your box instead of connect.prusa3d.com (register → token → telemetry → START_URL_DOWNLOAD). The wire protocol was taken from the open-source prusa-connect-sdk-printer and is verified end-to-end against that real client.

Layout

fleetq/          the server (FastAPI + SQLModel) — pip-installable package
  fleetq/          app: prusalink client, dispatcher, connect_server, dashboard
  docs/CONNECT_PROTOCOL.md   the reverse-derived phone-home protocol spec
  tests/
homeassistant/   run fleetq on a Home Assistant node
  addon/           HA add-on (containerized server, ingress + phone-home port)
  custom_components/fleetq/   thin HA integration (entities, services, events)

Quick start (standalone)

cd fleetq
pip install -e '.[dev]'
python -m fleetq          # http://localhost:8000  (dashboard + API + /docs)

See fleetq/README.md for the server, and homeassistant/README.md for the HA add-on + integration.

Name

fleetq deliberately avoids "Prusa" — that's a live trademark. This project is independent and not affiliated with Prusa Research.