ml5js · yiyujin · Jun 26, 2025 · Jul 2, 2025 · Jul 10, 2025 · Jul 11, 2025
diff --git a/examples/objectDetection-image/dog_cat.jpg b/examples/objectDetection-image/dog_cat.jpg
diff --git a/examples/objectDetection-image/index.html b/examples/objectDetection-image/index.html
@@ -0,0 +1,24 @@
+<!--
+  👋 Hello! This is an ml5.js example made and shared with ❤️.
+  Learn more about the ml5.js project: https://ml5js.org/
+  ml5.js license and Code of Conduct: https://github.com/ml5js/ml5-next-gen/blob/main/LICENSE.md
+
+  This example demonstrates object detection on a single image through ml5.objectDetector.
+-->
+
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>ml5.js objectDetector Example - Single Image</title>
+    <script src="https://cdn.jsdelivr.net/npm/[email protected]/lib/p5.js"></script>
+    <script src="../../dist/ml5.js"></script>
+  </head>
+  <body>
+    <main>
+    </main>
+    <script src="sketch.js"></script>
+  </body>
+</html>
diff --git a/examples/objectDetection-image/sketch.js b/examples/objectDetection-image/sketch.js
@@ -0,0 +1,44 @@
+/*
+ * 👋 Hello! This is an ml5.js example made and shared with ❤️.
+ * Learn more about the ml5.js project: https://ml5js.org/
+ * ml5.js license and Code of Conduct: https://github.com/ml5js/ml5-next-gen/blob/main/LICENSE.md
+ *
+ * This example demonstrates detecting objects in a live video through ml5.imageClassifier.
+ */
+
+let img;
+let detector;
+let detections = [];
+
+function preload(){
+  detector = ml5.objectDetector("cocossd");
+  img = loadImage('dog_cat.jpg');
+}
+
+function setup() {
+  createCanvas(640, 480);
+  image(img, 0, 0);
+  detector.detectStart(img, gotDetections);
+}
+
+// Callback function is called each time the object detector finishes processing a frame.
+function gotDetections(results) {
+  // Update detections array with the new results
+  detections = results;
+
+  for (let i = 0; i < detections.length; i += 1) {
+    let detection = detections[i];
+
+    // Draw bounding box
+    stroke(0, 255, 0);
+    strokeWeight(4);
+    noFill();
+    rect(detection.x, detection.y, detection.width, detection.height);
+
+    // Draw label
+    noStroke();
+    fill(255);
+    textSize(24);
+    text(detection.label, detection.x + 10, detection.y + 24);
+  }
+}
diff --git a/examples/objectDetection-video/ball_lifting.mp4 b/examples/objectDetection-video/ball_lifting.mp4
diff --git a/examples/objectDetection-video/index.html b/examples/objectDetection-video/index.html
@@ -0,0 +1,24 @@
+<!--
+  👋 Hello! This is an ml5.js example made and shared with ❤️.
+  Learn more about the ml5.js project: https://ml5js.org/
+  ml5.js license and Code of Conduct: https://github.com/ml5js/ml5-next-gen/blob/main/LICENSE.md
+
+  This example demonstrates object detection on a video through ml5.objectDetector.
+-->
+
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>ml5.js objectDetector Example - Video</title>
+    <script src="https://cdn.jsdelivr.net/npm/[email protected]/lib/p5.js"></script>
+    <script src="../../dist/ml5.js"></script>
+  </head>
+  <body>
+    <main>
+    </main>
+    <script src="sketch.js"></script>
+  </body>
+</html>
diff --git a/examples/objectDetection-video/sketch.js b/examples/objectDetection-video/sketch.js
@@ -0,0 +1,55 @@
+/*
+* 👋 Hello! This is an ml5.js example made and shared with ❤️.
+* Learn more about the ml5.js project: https://ml5js.org
+* ml5.js license and Code of Conduct: https://github.com/ml5js/ml5-next-gen/blob/main/LICENSE.md
+*
+* This example demonstrates detecting objects in a video file through ml5.objectDetector.
+*/
+
+let video;
+let detector;
+let detections = [];
+
+function preload(){
+  detector = ml5.objectDetector("cocossd");
+}
+
+// Callback function is called each time the object detector finishes processing a frame.
+function gotDetections(results) {
+  // Update detections array with the new results
+  detections = results;  
+}
+
+function setup() {
+  createCanvas(640, 480);
+
+  // Load and loop the video for object detection
+  video = createVideo('test.mp4'); // video sized 640 x 480
+  video.hide();
+  video.loop();
+
+  detector.detectStart(video, gotDetections);
+}
+
+function draw(){
+  image(video, 0, 0); // draw video frame
+
+  for (let i = 0; i < detections.length; i++) {
+    let detection = detections[i];
+
+    let x = detection.x;
+    let y = detection.y;
+    let w = detection.width;
+    let h = detection.height;
+
+    stroke(0, 255, 0);
+    strokeWeight(4);
+    noFill();
+    rect(x, y, w, h);
+
+    noStroke();
+    fill(255);
+    textSize(18);
+    text(detection.label, x + 5, y + 20);
+  }
+}
diff --git a/examples/objectDetection-webcam/index.html b/examples/objectDetection-webcam/index.html
@@ -0,0 +1,24 @@
+<!--
+  👋 Hello! This is an ml5.js example made and shared with ❤️.
+  Learn more about the ml5.js project: https://ml5js.org/
+  ml5.js license and Code of Conduct: https://github.com/ml5js/ml5-next-gen/blob/main/LICENSE.md
+
+  This example demonstrates object detection on live video through ml5.objectDetector.
+-->
+
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>ml5.js objectDetector Example - Webcam</title>
+    <script src="https://cdn.jsdelivr.net/npm/[email protected]/lib/p5.js"></script>
+    <script src="../../dist/ml5.js"></script>
+  </head>
+  <body>
+    <main>
+    </main>
+    <script src="sketch.js"></script>
+  </body>
+</html>
diff --git a/examples/objectDetection-webcam/sketch.js b/examples/objectDetection-webcam/sketch.js
@@ -0,0 +1,53 @@
+/*
+ * 👋 Hello! This is an ml5.js example made and shared with ❤️.
+ * Learn more about the ml5.js project: https://ml5js.org/
+ * ml5.js license and Code of Conduct: https://github.com/ml5js/ml5-next-gen/blob/main/LICENSE.md
+ *
+ * This example demonstrates detecting objects in a live video through ml5.imageClassifier.
+ */
+
+let video;
+let detector;
+let detections = [];
+
+function preload(){
+  detector = ml5.objectDetector("cocossd");
+}
+
+function setup() {
+  createCanvas(640, 480);
+
+  // Using webcam feed as video input, hiding html element to avoid duplicate with canvas
+  video = createCapture(VIDEO);
+  video.size(width, height);
+  video.hide();
+
+  detector.detectStart(video, gotDetections);
+}
+
+// Callback function is called each time the object detector finishes processing a frame.
+function gotDetections(results) {
+  // Update detections array with the new results
+  detections = results;
+}
+
+function draw() {
+  // Draw the current video frame onto the canvas.
+  image(video, 0, 0);
+
+  for (let i = 0; i < detections.length; i += 1) {
+    let detection = detections[i];
+
+    // Draw bounding box
+    stroke(0, 255, 0);
+    strokeWeight(4);
+    noFill();
+    rect(detection.x, detection.y, detection.width, detection.height);
+
+    // Draw label
+    noStroke();
+    fill(255);
+    textSize(24);
+    text(detection.label, detection.x + 10, detection.y + 24);
+  }
+}
diff --git a/package.json b/package.json
@@ -57,6 +57,7 @@
     "@mediapipe/pose": "^0.5.1675469404",
     "@mediapipe/selfie_segmentation": "~0.1.0",
     "@tensorflow-models/body-segmentation": "^1.0.1",
+    "@tensorflow-models/coco-ssd": "^2.2.3",
     "@tensorflow-models/depth-estimation": "^0.0.4",
     "@tensorflow-models/face-landmarks-detection": "1.0.5",
     "@tensorflow-models/hand-pose-detection": "^2.0.0",

diff --git a/src/ObjectDetector/cocossd.js b/src/ObjectDetector/cocossd.js
@@ -0,0 +1,72 @@
+// Copyright (c) 2019 ml5
+//
+// This software is released under the MIT License.
+// https://opensource.org/licenses/MIT
+
+/*
+    COCO-SSD Object detection model
+    Wraps the coco-ssd model in tfjs to be used in ml5
+*/
+import * as tf from "@tensorflow/tfjs";
+import * as cocoSsd from "@tensorflow-models/coco-ssd";
+import { mediaReady } from "../utils/imageUtilities";
+
+const DEFAULTS = {
+  base: "lite_mobilenet_v2",
+  modelUrl: undefined,
+};
+
+export class CocoSsd {
+  constructor(options = {}) {
+    this.model = null;
+    this.config = {
+      base: options.base || DEFAULTS.base,
+      modelUrl: options.modelUrl || DEFAULTS.modelUrl,
+    };
+  }
+
+  async load() {
+    await tf.setBackend("webgl"); // this line resolves warning : performance is poor on webgpu backend
+    await tf.ready();
+
+    this.model = await cocoSsd.load(this.config);
+    return this;
+  }
+
+  /**
+   * Detect objects that are in the image/video/canvas
+   * @param {HTMLVideoElement|HTMLImageElement|HTMLCanvasElement|ImageData} imgToPredict - Subject of the detection.
+   * @returns {Array} Array of detection detections
+   */
+  async detect(imgToPredict) {
+    mediaReady(imgToPredict, true);
+
+    await tf.nextFrame();
+
+    const detections = await this.model.detect(imgToPredict);
+    const formattedDetections = detections.map(prediction => {
+      return {
+        label: prediction.class,
+        confidence: prediction.score,
+        x: prediction.bbox[0],
+        y: prediction.bbox[1],
+        width: prediction.bbox[2],
+        height: prediction.bbox[3],
+        normalized: {
+          x: prediction.bbox[0] / imgToPredict.width,
+          y: prediction.bbox[1] / imgToPredict.height,
+          width: prediction.bbox[2] / imgToPredict.width,
+          height: prediction.bbox[3] / imgToPredict.height,
+        },
+      };
+    });
+
+    return formattedDetections;
+  }
+}
+
+export async function load(modelConfig = {}) {
+  const cocoSsdInstance = new CocoSsd(modelConfig);
+  await cocoSsdInstance.load();
+  return cocoSsdInstance;
+}