kami-package-detection

name	kami-package-detection
description	A free skill by Kami SmartHome. Get notified the moment a package arrives at your door. Detects packages, parcels, and bags from RTSP camera streams using AI vision.
version	1.0.4
author	kami-smarthome
tags	["smart-home","kami","home-assistant","smarthome","detect","object-detection","yolo","package-detection","parcel-detection","iot","camera","rtsp","onnx","edge-ai","delivery","monitoring","notification"]
triggers	["smart home","kami","home assistant","detect","detect packages","detect parcels","kami package","kami smart home","home assistant package","smart home delivery","check doorstep","delivery notification","check for deliveries","package detection","is there a package","monitor packages","check camera for packages","any deliveries at the door","parcel alert"]
metadata	{"openclaw":{"requires":{"bins":"[Truncated]"},"emoji":"📦"}}

Kami Package Detection

Get notified the moment a package arrives at your door.

Monitor your camera feed for packages, parcels, backpacks, handbags, and suitcases. When detected, returns the object class and bounding box as JSON — ready for automation.

Features

• 📦 Package & parcel detection
• 🧳 Suitcase / backpack / handbag recognition
• 🏠 Doorstep & reception monitoring
• ⏱ Configurable detection duration
• 🔔 JSON output for easy integration

Scenarios

• Doorstep delivery waiting
• Office reception package management
• Warehouse cargo monitoring
• Temporary item watch

Installation

bash setup.sh

Creates .venv/ and installs onnxruntime, opencv-python-headless, numpy. Idempotent.

Prerequisites

• python3 and python3-venv installed
• yolov8s-worldv2.onnx model file in the skill directory
• RTSP camera online and reachable

Model

The yolov8s-worldv2.onnx model file is included in the skill package. If missing, re-download this skill from ClawHub:

clawhub install kami-package-detection

Alternatively, download the YOLOv8s-World v2 .pt model from Ultralytics YOLO-World and export it to ONNX yourself. Make sure the class names used during export match the --class_names parameter:

pip install ultralytics
yolo export model=yolov8s-worldv2.pt format=onnx imgsz=320
cp yolov8s-worldv2.onnx /path/to/kami-package-detection/

Parameter Confirmation

Before running, confirm these parameters with the user:

Parameter	Default	Description
--rtsp_url	rtsp://127.0.0.1/live/TNPUSAQ-757597-DRFMY	RTSP camera URL
--conf_threshold