PHPackages                             ac-dc/face - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. ac-dc/face

ActiveLibrary

ac-dc/face
==========

v2.0.1(4y ago)07MITPHPPHP >=5.6.4

Since Jul 1Pushed 4y agoCompare

[ Source](https://github.com/ac-dc/face)[ Packagist](https://packagist.org/packages/ac-dc/face)[ RSS](/packages/ac-dc-face/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (5)Versions (7)Used By (0)

[![](.github/face-logo.png)](.github/face-logo.png)

 [ ![](https://camo.githubusercontent.com/7addf299d58fd481270d4d0dd513752e521978fadd6231f695a0656c070bb90d/68747470733a2f2f636972636c6563692e636f6d2f67682f6564756172646f7374756172742f666163652e7376673f7374796c653d736869656c6426636972636c652d746f6b656e3d37633066386435396365616238386262356361386435303036343430316236363435383939363165) ](https://circleci.com/gh/eduardostuart/face) [![](https://camo.githubusercontent.com/32055d16ce3ed9dc55b10751c390dc4b4c69e3f19a23bcc929d449828fd3ace5/68747470733a2f2f706f7365722e707567782e6f72672f6564756172646f7374756172742f666163652f6c6963656e7365)](https://camo.githubusercontent.com/32055d16ce3ed9dc55b10751c390dc4b4c69e3f19a23bcc929d449828fd3ace5/68747470733a2f2f706f7365722e707567782e6f72672f6564756172646f7374756172742f666163652f6c6963656e7365)

Table of contents
-----------------

[](#table-of-contents)

1. [Installation](#installation)
2. [Configuration](#configuration)
3. [How to use](#how-to-use)
    1. [Detect api](#detect)
    2. [Albums](#albums)
        1. [Create](#create-album)
        2. [Update](#update-album)
        3. [Delete](#delete-album)
        4. [Get all albums](#get-all-albums)
        5. [Get an album](#get-an-album)
        6. [Add face into an album](#add-face-into-an-album)
        7. [Remove face from album](#remove-face-from-album)
    3. [Search](#search)
    4. [Get a Face](#get-a-face)
4. [License](#license)
5. [Security](#security)

Installation
------------

[](#installation)

To get the latest version, require the project using composer:

```
composer require eduardostuart/face
```

Once installed, you need to register the `Face Service provider` in your `config/app.php`.

```
return [
    // ....
    Face\FaceServiceProvider::class,
]
```

And add Face Facade into config/app.php.

```
return [
    // ....
    'Face' => Face\Facades\Face::class,
]
```

Configuration
-------------

[](#configuration)

To start using Laravel Face, you need to publish `Face` configuration file.

```
php artisan vendor:publish --provider="Face\FaceServiceProvider"
```

You also need to add credentials (or custom settings) for services that your application utilizes. These informations should be placed in `config/face.php` file.

How to use
----------

[](#how-to-use)

### Detect

[](#detect)

Detect and analyzes human faces.

```
// ...
use Face;

$results = Face::detect('https://.../photo.jpg');
```

Albums
------

[](#albums)

### Create album

[](#create-album)

```
// ...
use Face;

$album = Face::createAlbum("my album name", [
    "face-id-1", "face-id-2",
]);

// $album->getName();
// $album->getTags();
// $album->getFaces();
// $album->toJson();
// $album->toArray();
```

### Remove album

[](#remove-album)

```
// ...
use Face;

if(Face::removeAlbum("album-id")){
    echo "OK!";
}
```

### Update album

[](#update-album)

```
// ...
use Face;

$albumUpdated = Face::updateAlbum("album-id", "new album name");
```

### Get all albums

[](#get-all-albums)

```
// ...
use Face;

$albums = Face::albums();
print_r($albums->toArray());
```

### Get an album

[](#get-an-album)

```
// ...
use Face;

$album = Face::album("album-id");
echo $album->getName();
```

### Add face into an album

[](#add-face-into-an-album)

```
// ...
use Face;

if(Face::addIntoAlbum("album-id", ["face-1-id","face-2-id"])){
    echo "Added!";
}
```

### Remove face from album

[](#remove-face-from-album)

```
// ...
use Face;

if(Face::removeFaceFromAlbum("album-id", ["face-1-id","face-2-id"])){
    echo "Removed!";
}
```

### Search

[](#search)

Find one or more similar faces.

```
// ...
use Face;

$albumId = '1234';

$result = Face::search($albumId, 'https://.../photo.jpg');

// $result->getTotal();
// $result->getResults();
```

### Get a Face

[](#get-a-face)

```
// ...
use Face;

$result = Face::getFace('face-id');

// $result->getAttributes();
// $result->getId();
// $result->getReference();
```

Providers
---------

[](#providers)

- [Face++](https://faceplusplus.com)
- [Lambda Labs](https://lambdal.com/face-recognition-api)
- [Sky Biometry](https://skybiometry.com)
- [Kairos](https://kairos.com)
- [Microsoft](https://azure.microsoft.com/en-us/try/cognitive-services/?api=computer-vision)

License
-------

[](#license)

Face is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT)

Security
--------

[](#security)

If you discover a security vulnerability within this package, please send an e-mail to Eduardo Stuart at . All security vulnerabilities will be promptly addressed.

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 95.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~409 days

Total

5

Last Release

1607d ago

Major Versions

0.1 → 1.02017-07-02

v1.0.x-dev → v2.0.02017-09-18

### Community

Maintainers

![](https://www.gravatar.com/avatar/c11a8caafda272b4d6a2c49a0e60effd19d406545fde2780befd068443643e98?d=identicon)[ac-dc](/maintainers/ac-dc)

---

Top Contributors

[![eduardostuart](https://avatars.githubusercontent.com/u/767879?v=4)](https://github.com/eduardostuart "eduardostuart (39 commits)")[![ConnorVG](https://avatars.githubusercontent.com/u/3260091?v=4)](https://github.com/ConnorVG "ConnorVG (1 commits)")[![Dylan-DPC](https://avatars.githubusercontent.com/u/99973273?v=4)](https://github.com/Dylan-DPC "Dylan-DPC (1 commits)")

---

Tags

face detection

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/ac-dc-face/health.svg)

```
[![Health](https://phpackages.com/badges/ac-dc-face/health.svg)](https://phpackages.com/packages/ac-dc-face)
```

###  Alternatives

[s-ichikawa/laravel-sendgrid-driver

This library adds a 'sendgrid' mail driver to Laravel.

4139.3M1](/packages/s-ichikawa-laravel-sendgrid-driver)[stechstudio/laravel-zipstream

A fast and simple streaming zip file downloader for Laravel.

4633.7M3](/packages/stechstudio-laravel-zipstream)[laravel-notification-channels/microsoft-teams

A Laravel Notification Channel for Microsoft Teams

1603.0M7](/packages/laravel-notification-channels-microsoft-teams)[spatie/laravel-export

Create a static site bundle from a Laravel app

646127.9k5](/packages/spatie-laravel-export)[erag/laravel-disposable-email

A Laravel package to detect and block disposable email addresses.

226102.4k](/packages/erag-laravel-disposable-email)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)