Metadata-Version: 2.4
Name: bozun
Version: 0.0.1
Summary: Resource-aware supervisor daemon for Klipper-based 3D printers (Bowden changer, sensor fusion, autonomous failure recovery)
Author: Francisco Stephens
License-Expression: AGPL-3.0-or-later
Keywords: 3d-printing,bowden,klipper,moonraker,sensor-fusion
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Printing
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# Bozun

**Bozun** is a resource-aware supervisor daemon for Klipper-based 3D printers.

> *Bosun/Bozun: the officer responsible for the ship's equipment and crew — keeping everything running smoothly.*
> *Bozun = **Bo**wden + cli**pp**er/Kli**pp**er + Moon**rake**r + Main**sail** + Bo**zun***

Bozun bridges Klipper's real-time motion control with a smart sensor network that autonomously detects and recovers from print failures — clogs, layer shifts, filament runouts, heat creep, and more — without stopping the print unless absolutely necessary.

## Status

🚧 **Active development — pre-release.** This package reserves the name on PyPI. A working release will follow.

## Key Features (planned)

- **Sensor fusion engine** — load cell, BMI160 accelerometer, BME680 environmental sensor, extruder gear switches
- **Autonomous failure recovery** — graduated responses before resorting to pause/cancel
- **Bowden tube changer integration** — handshake with Happy Hare for seamless multi-material
- **Kiosk UI** — purpose-built web interface for 3.5" resistive touchscreens (480×320)
- **Power loss recovery** — automatic resume after outages via sacrificial USB drive
- **Resource governor** — AI vision runs only when Klipper has free cycles

## License

AGPL-3.0-or-later
