# FaceRecognition - Ionic-Cordova

This demo demonstrates both Face Liveness Detection and Face Recognition with Ionic Cordova framwork for biometric authentication system.

It stands for face recognition Ionic, facial recognition Ionic, face liveness check Ionic, face spoofing prevention Ionic, face matching Ionic, face comparison Ionic, face search engine Ionic, face identification Ionic, etc.

## Github

{% embed url="<https://github.com/kby-ai/FaceRecognition-Ionic-Cordova>" %}

## Google Play

{% embed url="<https://play.google.com/store/apps/details?hl=en_US&id=com.kbyai.facerecognition>" %}

## App Store

{% embed url="<https://apps.apple.com/us/app/kby-ai-face-recognition/id6448648922>" %}

## YouTube

{% embed url="<https://youtu.be/HpDggnWsG1c>" %}

## How to Run

### 1. Prerequisites

Make sure you have `Node.js` and `npm` installed.

Download and install `Node.js` from official websites, and then make sure it's installed or not by running the following commands.

```bash
node -v
npm -v
```

Install `Ionic` CLI globally with npm:

<pre class="language-bash"><code class="lang-bash"><strong>npm install -g @ionic/cli
</strong></code></pre>

Install `Cordova` framework globally as well.

```bash
npm install -g cordova
```

### 2. Running the Android App

2.1. **Add `FacePlugin` To The Project**

Run the following command to add the `FacePlugin` to the `Ionic Cordova` project.

```bash
ionic cordova plugin add ./FacePlugin  
```

2.2. **Build `Android` App**

<pre class="language-bash"><code class="lang-bash"><strong>ionic cordova build android
</strong></code></pre>

2.3. **Add `Camera Permission` App**

Add camera permission on `AndroidManifest.xml` placed at `platforms/android/app/src/main`.

```xml
<uses-permission android:name="android.permission.CAMERA" />
```

Once the camera permission is allowed and app is built, the app can be run on `Android` device with the following command.

```bash
ionic cordova run android
```

### 3. Running the iOS App

3.1. **Add `FacePlugin` To The Project**

Run the following command to add the `FacePlugin` to the `Ionic Cordova` project.

```bash
ionic cordova plugin add ./FacePlugin
```

3.2. **Add `iOS` Platform To The Project**

```bash
ionic cordova platform add ios
```

3.3. **Prepare`iOS` Project**

```bash
ionic cordova prepare ios
```

3.4. **Add`Camera Permission` To `Info.plist`**&#x20;

Open `iOS` workspace in `Xcode`.

```bash
open platforms/ios/face-recognition.xcworkspace
```

Then navigate to the file `Info.plist` in `Xcode`, and add the following entry to request camera permission.

```bash
<key>NSCameraUsageDescription</key>
<string>We need access to your camera for face recognition.</string>
```

Build app finally with `Xcode` and run it on a real device, not simulator


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kby-ai.com/help/demo-projects/mobile-android-ios/facerecognition-ionic-cordova.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.