PHPackages                             coolseven/face-platform-sdk - 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. [API Development](/categories/api)
4. /
5. coolseven/face-platform-sdk

ActiveLibrary[API Development](/categories/api)

coolseven/face-platform-sdk
===========================

Face Platform Api Client For Laravel

v1.3.0(6y ago)037[1 issues](https://github.com/coolseven/face-platform-sdk/issues)GPL-3.0-or-laterPHPPHP ^7.2CI failing

Since Sep 25Pushed 6y ago1 watchersCompare

[ Source](https://github.com/coolseven/face-platform-sdk)[ Packagist](https://packagist.org/packages/coolseven/face-platform-sdk)[ RSS](/packages/coolseven-face-platform-sdk/feed)WikiDiscussions master Synced 2d ago

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

face-platform-sdk
=================

[](#face-platform-sdk)

Face Platform Api client for Laravel

Requirement
-----------

[](#requirement)

- php >= 7.2
- laravel >= 6.0

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

[](#installation)

### Install package

[](#install-package)

```
composer require coolseven/face-platform-sdk
```

### Setup environments

[](#setup-environments)

- add following environments to your .env file

```
FACE_PLATFORM_OAUTH_SERVER=
FACE_PLATFORM_RESOURCE_SERVER=
FACE_PLATFORM_CLIENT_ID=
FACE_PLATFORM_CLIENT_SECRET=
FACE_PLATFORM_USERNAME=
FACE_PLATFORM_PASSWORD=

# the cache store should be one of the stores you defined in config/cache.php
# will use 'file' as cache store if not set
FACE_PLATFORM_CACHE_STORE=file
# the cache key to store your face platform access token,
# will use 'cache:face-platform:access_token' as cache key if not set
FACE_PLATFORM_CACHE_KEY=cache:face-platform:access_token
```

- publish config file ( optional )

```
php artisan vendor:publish --tag=face-platform-sdk.config
```

the config file will be copied to your config dir with filename "face-platform-sdk.php"

Manage Resources
----------------

[](#manage-resources)

- create a new face set

```
$facePlatformClient = app(Coolseven\FacePlatformSdk\FacePlatformClient::class);
// or $facePlatformClient = app('face-platform-client')

$faceSetName = 'your-demo-face-set';
$response = $facePlatformClient->createFaceSet($faceSetName);
$faceSetId = $response->getFaceSet()->getId();
$statusCode = $response->getRawResponse()->getStatusCode();
```

- import faces into a face set

```
$facePlatformClient = app(Coolseven\FacePlatformSdk\FacePlatformClient::class);
$faceSetId = 'your-demo-face-set-id';
$imagePath = 'your_imgae_file_path';
$response = $facePlatformClient->importFaces($faceSetId, base64_encode(file_get_contents($imagePath)));
$importedFaces = $response->getImportedFaces();
```

- search similar faces in a face set

```
$facePlatformClient = app(Coolseven\FacePlatformSdk\FacePlatformClient::class);
$faceSetId = 'your-demo-face-set-id';
$imagePath = 'your_imgae_file_path';
$similarityThreshold = 0.93;
$response = $facePlatformClient->searchSimilarFaces($faceSetId, base64_encode(file_get_contents($imagePath)), $similarityThreshold);
$similarFaces = $response->getSimilarFaces();
```

Events
------

[](#events)

- a `Coolseven\FacePlatformSdk\Events\AccessTokenRefreshed` Event will be fired after access token been refreshed.

```
$accessToken = $accessTokenRefreshedEvent->getRefreshedAccessToken();
```

- a `Coolseven\FacePlatformSdk\Events\FaceSetCreated` Event will be fired after a new face set been created.

```
$faceSetId = $faceSetCreatedEvent->getFaceSet()->getId();
$rawResponse = $faceSetCreatedEvent->getRawResponse();
```

- a `Coolseven\FacePlatformSdk\Events\FacesImported` Event will be fired after new faces been imported

```
$importedFaces = $facesImportedEvent->getImportedFaces();
$faceSetId = $facesImportedEvent->getFaceSetId();
$imageBase64 = $facesImportedEvent->getImageBase64();
$rawResponse = $facesImportedEvent->getRawResponse();
```

- a `Coolseven\FacePlatformSdk\Events\SimilarFacesSearched` Event will be fired after similar faces been searched

```
$similarFaces = $similarFacesSearchedEvent->getSimilarFaces();
$faceSetId = $similarFacesSearchedEvent->getFaceSetId();
$imageBase64 = $similarFacesSearchedEvent->getImageBase64();
$rawResponse = $similarFacesSearchedEvent->getRawResponse();
```

###  Health Score

26

—

LowBetter than 41% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~1 days

Total

5

Last Release

2467d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/571574dbb87874543bc0da5e009f3a622f7ff58d322f0b335ece7fc404823ebf?d=identicon)[coolseven](/maintainers/coolseven)

---

Top Contributors

[![coolseven](https://avatars.githubusercontent.com/u/9546869?v=4)](https://github.com/coolseven "coolseven (16 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/coolseven-face-platform-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/coolseven-face-platform-sdk/health.svg)](https://phpackages.com/packages/coolseven-face-platform-sdk)
```

###  Alternatives

[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9772.3M122](/packages/roots-acorn)[psalm/plugin-laravel

Psalm plugin for Laravel

3345.1M337](/packages/psalm-plugin-laravel)[aedart/athenaeum

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

245.2k](/packages/aedart-athenaeum)[flarum/core

Delightfully simple forum software.

201.4M2.2k](/packages/flarum-core)[simplestats-io/laravel-client

Analytics for Laravel. Track visitors, registrations, and payments. Discover which channels actually drive revenue, not just traffic. Server-side, GDPR compliant, ad-blocker proof.

5019.3k](/packages/simplestats-io-laravel-client)[jasara/php-amzn-selling-partner-api

A fluent interface for Amazon's Selling Partner API in PHP

1348.1k1](/packages/jasara-php-amzn-selling-partner-api)

PHPackages © 2026

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