ai-image-analyzer

ai-image-analyzer is a powerful Node.js library that leverages TensorFlow.js to classify images and detect objects using pre-trained models like MobileNet and COCO-SSD. It supports input as either a file path or an image buffer for enhanced flexibility.

Features

- Image Classification: Classify images using the MobileNet model.
- Object Detection: Detect objects in images using the COCO-SSD model.
- Flexible Input: Accepts file paths or raw image buffers as input.

❤️ Support My Work!

Maintaining this package requires effort and dedication. If this project helped you, consider buying me a coffee or supporting me via PayPal. Every donation helps keep this project alive!


Installation

``
npm install ai-image-analyzer
`

Usage


Import the Library
`
import { classifyImage, detectObjects } from 'ai-image-analyzer';
`

Image Classification

`
const predictions = await classifyImage('/path/to/image.jpg');
// OR
import { readFileSync } from 'fs';
const imageBuffer = readFileSync('/path/to/image.jpg');
const predictions = await classifyImage(imageBuffer);

console.log('Predictions:', predictions);
`


Object Detection


`
const detections = await detectObjects('/path/to/image.jpg');
// OR
const imageBuffer = readFileSync('/path/to/image.jpg');
const detections = await detectObjects(imageBuffer);

console.log('Detections:', detections);
`

Output Format


Image Classification
The classifyImage function returns an array of predictions:
`
[
{
"className": "object name",
"probability": 0.95
},
{
"className": "another object name",
"probability": 0.85
}
]
`

Object Detection
The detectObjects function returns an array of detections:
`
[
{
"bbox": [x, y, width, height],
"class": "object name",
"score": 0.9
},
{
"bbox": [x, y, width, height],
"class": "another object name",
"score": 0.8
}
]
`

Requirements

* Node.js 16 or later
* TensorFlow.js dependencies (@tensorflow/tfjs-node, @tensorflow-models/mobilenet, @tensorflow-models/coco-ssd)

API Reference

`
classifyImage(imageInput: string | Buffer): Promise
`
Classifies the input image and returns an array of predictions.

* imageInput: Path to the image file or an image buffer.
* Returns: Array of predictions with class names and probabilities.

`
detectObjects(imageInput: string | Buffer): Promise
``
Detects objects in the input image and returns an array of detections.

* imageInput: Path to the image file or an image buffer.
* Returns: Array of detections with bounding boxes, class names, and scores.

License

This project is licensed under the MIT License. See the LICENSE file for details.