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
python3andpython3-venvinstalledyolov8s-worldv2.onnxmodel 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
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 | 0.25 | Confidence threshold (0.0–1.0) |
--class_names | parcel package "delivery box" person "Cardboard box" "Packaging Box" backpack handbag suitcase | Classes to detect |
--run_time | 60 | Max seconds; 0 = unlimited |
Ask the user: do any parameters need to be changed?
Usage
.venv/bin/python yolo_world_onnx.py \
--rtsp_url rtsp://your-camera-address \
--run_time 60
Output (stdout JSON)
{
"detections": [
{
"class_name": "parcel",
"bbox": {"x1": 100, "y1": 200, "x2": 300, "y2": 400}
}
]
}
| Field | Type | Description |
|---|---|---|
class_name | string | Detected object class |
bbox.x1, y1, x2, y2 | int | Bounding box coordinates |
Exit Codes
| Code | Meaning |
|---|---|
0 | Target detected, JSON output written |
1 | Error (model missing, RTSP failure, runtime exception) |
2 | Timeout, no target detected within --run_time |
Troubleshooting
bash: .venv/bin/python: No such file or directory→ Runbash setup.shModel file not found→ Placeyolov8s-worldv2.onnxin the skill directoryCannot open video→ Check camera is online and--rtsp_urlis correct