# @nativescript/mlkit-face-detection

> NativeScript MLKit Face Detection module

Latest version **3.0.4** (published 2025-10-23) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @nativescript/mlkit-face-detection
pnpm add @nativescript/mlkit-face-detection
yarn add @nativescript/mlkit-face-detection
bun add @nativescript/mlkit-face-detection
```

## Health

**Score 30/100 (F)** — status: maintenance-mode.

Positive: has types; no vulnerabilities.

Warnings: low downloads; no esm support.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 3.0.4 |
| Published | 2025-10-23 |
| First published | 2021-11-15 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 15.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 30 |
| Author | NativeScript |
| Maintainers | rigor789, nativescript-bot |
| Keywords | NativeScript, JavaScript, TypeScript, iOS, Android |

## Links

- npm: https://www.npmjs.com/package/@nativescript/mlkit-face-detection
- Repository: https://github.com/NativeScript/mlkit
- Issues: https://github.com/NativeScript/mlkit/issues
- npm.io page: https://npm.io/package/@nativescript/mlkit-face-detection

## Alternatives

- [@openai/codex-sdk](https://npm.io/package/@openai/codex-sdk.md) — 731.4K weekly downloads
- [babel-plugin-transform-react-jsx](https://npm.io/package/babel-plugin-transform-react-jsx.md) — 565.0K weekly downloads
- [babel-helper-remove-or-void](https://npm.io/package/babel-helper-remove-or-void.md) — 508.5K weekly downloads
- [@pnpm/store-controller-types](https://npm.io/package/@pnpm/store-controller-types.md) — 186.9K weekly downloads
- [react-native-signature-canvas](https://npm.io/package/react-native-signature-canvas.md) — 155.6K weekly downloads

## Recent versions

- 3.0.4 (latest) — 2025-10-23
- 3.0.0-alpha.7 (alpha) — 2024-11-17
- 3.0.1 — 2025-07-22
- 3.0.0 — 2025-01-29
- 3.0.0-alpha.6 — 2024-10-11
- 3.0.0-alpha.5 — 2024-10-10
- 3.0.0-alpha.4 — 2024-10-10
- 3.0.0-alpha.3 — 2024-06-11
- 3.0.0-alpha.2 — 2024-06-09
- 3.0.0-alpha.1 — 2024-06-05
- 3.0.0-alpha.0 — 2024-05-24
- 2.1.0 — 2024-01-21
- 2.0.0 — 2023-03-28
- 2.0.0-alpha.1 — 2023-03-28
- 2.0.0-alpha.0 — 2023-03-28
- … 18 more at https://npm.io/package/@nativescript/mlkit-face-detection/versions

## README

# @nativescript/mlkit-face-detection

A plugin that is used with [@nativescript/mlkit-core](../plugins/mlkit-core/) to enable face detection and provide the [FaceResult](#faceresult) type for the data of the face detection event.

## Contents
* [Installation](#installation)
* [Use @nativescript/mlkit-face-detection](#use-nativescriptmlkit-face-detection)
* [API](#api)
    * [FaceResult](#faceresult)
* [License](#license)

## Installation
Install `@nativescript/mlkit-face-detection` by running the following command:

```cli
npm install @nativescript/mlkit-face-detection
```

## Use @nativescript/mlkit-face-detection

For more details, read [use @nativescript/mlkit-core](../mlkit-core#use-nativescriptmlkit-core) and [@nativescript/mlkit-core](../mlkit-core#face-detection)

## API

### FaceResult

The Face Detection event data type.

```ts
interface FaceResult {
    smilingProbability: number;
    leftEyeOpenProbability: number;
    rightEyeOpenProbability: number;
    trackingId: number;
    bounds: Bounds;
    headEulerAngleZ: number;
    headEulerAngleY: number;
    headEulerAngleX: number;
}
```

#### Bounds
```ts
interface Bounds {
    origin: Origin;
    size: Size;
}
```
#### Origin
```ts
interface Origin {
    x: number;
    y: number;
}
```
#### Size
```ts
interface Size {
    width: number;
    height: number;
}
```

## License

Apache License Version 2.0

---
_Source: https://npm.io/package/@nativescript/mlkit-face-detection · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
