Latest 1.3.2
License MIT
Platforms ios 8.0, requires ARC

Microsoft Face API: iOS Client Library & Sample

This repo contains the iOS client library & sample for the Microsoft Face API, an offering within Microsoft Cognitive Services, formerly known as Project Oxford.

The Client Library

The easiest way to consume the iOS client library is via CocoaPods. To install via Cocoapods

  1. Install Cocoapods – Follow the getting started guide to install Cocoapods.
  2. Add the following to your Podfile : pod 'ProjectOxfordFace'
  3. Run the command pod install to install the latest ProjectOxfordFace pod.
  4. Add #import <ProjectOxfordFace/MPOFaceSDK.h> to all files that need to reference the SDK.

The Sample

The sample app demonstrates the use of the Microsoft Face API iOS client library. The sample shows scenarios such as face detection, face verification, and face grouping.


iOS must be version 8.1 or higher.

Building and running the sample

The sample app should already have the necessary Pods shipped with it. Open the ProjectOxfordFace.xcworkspace in Xcode and build.

  1. First, you must obtain a Face API subscription key by

    Having issues?

    1. Make sure you have selected ProjectOxfordFace-Example as the target.
    2. Make sure you have included the subscription key in MPOTestConstants.h.
    3. Make sure you have opened the .xcworkspace file and not the .xcodeproj file in Xcode.
    4. Make sure you have used the correct Deployment Team profile.
    5. Make sure you are running iOS 8.1 or higher

    Running and exploring the unit tests

    Unit tests that demonstrate various Microsoft Cognitive Services scenarios such as detection, identification, grouping, similarity, verification, and face lists are located at Example/Tests.

    To run the unit tests, first insert your subscription key in MPOTestConstants.h and then select the test navigator pane in Xcode to display all of the tests which can be run.


    We welcome contributions. Feel free to file issues and pull requests on the repo and we’ll address them as we can. Learn more about how you can help on our ” target=”_blank”>StackOverflow

  2. Feedback & feature requests: Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.



    All Microsoft Cognitive Services SDKs and samples are licensed with the MIT License. For more details, see
    ” target=”_blank”>LICENSE-IMAGE.

    Developer Code of Conduct

    Developers using Cognitive Services, including this client library & sample, are expected to follow the “Developer Code of Conduct for Microsoft Cognitive Services”, found at

    Latest podspec

        "name": "ProjectOxfordFace",
        "version": "1.3.2",
        "summary": "Microsoft Cognitive Services - Face API iOS SDK",
        "description": "Integrate Microsoft Cognitive Services Face API into your iOS App!",
        "homepage": "",
        "screenshots": [
        "license": "MIT",
        "authors": {
            "Microsoft Cognitive Services SDK": "[email protected]"
        "source": {
            "git": "",
            "branch": "master",
            "tag": "1.3.2"
        "platforms": {
            "ios": "8.0"
        "requires_arc": true,
        "source_files": "Pod/Classes/**/*"

Pin It on Pinterest

Share This