Skip to content

esn814/OctoPrint-PiNozCam

 
 

Repository files navigation

OctoPrint-PiNozCam

Join Discord

Introduction

Welcome to the era of edge computing with free failure detection performed directly on your Pi

Device (50% of All Cores for AI) Inference Speed (images / minute)
Raspberry Pi 5 45
Raspberry Pi 4 9
Raspberry Pi 3B 5
PC with Intel i5 10600 260
OrangePi Zero 2/3 9
Raspberry Pi Zero 2 W 3

Unlock advanced 3D printing monitoring with PiNozCam, your go-to solution for AI-powered surveillance — all without any subscription or registration. PiNozCam brings cutting-edge computing to your Raspberry Pi or any old PC/single board computer, ensuring privacy and providing instant failure alerts via Telegram/Discord.

Features include:

  • Fast Inference on Pi Arm CPU/Local Device, 24/7 AI service
  • Instant Telegram/Discord Error Notifications
  • Privacy-first approach with RAM-only data storage
  • No email register/sign up/subscription/Cloud/Ads/Payment
  • Auto Pause/Stop Functionality

Support RPi OS platform (Don’t know❓):

OS platform Buster Bullseye Bookworm
arm64 (x64)
armhf (x32)

⚠️ This plugin supports the stable OctoPi image (Bullseye). For those utilizing 32-bit OctoPi Nightly (Bookworm armhf) or older OctoPi images (Buster armhf), it's essential to select arm64 builds for compatibility, or flash the stable OctoPi image.

RPi(Boardcom) Intel/AMD CPU AllWinner RockChip RAM
>=512MB

Plugin Setup

Install via the bundled Plugin Manager or manually using this URL:

https://github.com/DrAlexLiu/OctoPrint-PiNozCam/archive/master.zip

Required Hardware Setup

Endoscope Camera

Compatible with most market-available endoscope cameras.

Ensure your camera:

⚠️ Cleaning the camera lens before EACH print is highly recommended for dust removal.

Endoscope camera Bracket

Search and print a nozzle camera bracket for your camera model.

The setup would be like this:

Cellphone

To enable notifications, enter your Telegram bot token and chat ID or Discord Webhook url. Upon configuration and clicking "Save". A welcome message confirms successful setup. An example failure notification will be sent like this:

Software Configuration

Navigate to the PiNozCam tab:

The screenshot:

Key Parameters:

  • Action: Specifies the action PiNozCam should take when a print failure is detected (e.g., notify only, pause print, stop print). Detected failures are displayed in the video stream for 5 seconds, allowing for immediate visual verification.
  • Image Sensitivity: Adjust the sensitivity to ensure accurate detection of print failures. Set the threshold to balance between premature stopping for minor issues and delaying action for significant errors. A starting value of 0.04 or 4% is recommended for optimal balance.
  • Failure Scores Threshold: Define the confidence level at which an anomaly is considered a print failure. This setting helps in reducing false alarms by setting a minimum probability threshold for errors, ensuring that only genuine failures prompt action.
  • Max Failure Count: Specify the number of detections required in Failure Consider Time before PiNozCam takes the configured action. A value above 1 is recommended to avoid false positives.
  • Failure Consider Time (s): Implement a time buffer to focus on recent failures, ignoring older detections that may no longer be relevant. This dynamic consideration helps in adapting to the current state of the print.
  • CPU Speed Control: Offers options for running the CPU at half or full speed. Half speed is recommended.

Initially, stick with the default settings and adjust them gradually to fine-tune performance.

Support

For further discussion and support, please join our Discord channel.

About

AI model running on RPi for failure detection

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Python 78.0%
  • JavaScript 13.4%
  • Jinja 8.5%
  • CSS 0.1%