face.com Python API client

    .-"""""""-.
  .'  _   _    `.
 /   (o) (o)     \
|       ^         |====.      POST /faces/detect
|      '-'        | [] ||==>  POST /faces/recognize
|   .-.___.-.     |====''     POST /faces/train
 \  \       /    /            POST /tags/save
  `. `-----'  .'              {image} -> {tags}
    `-.___.-'                 /api

Archived project. This repository is now a read-only snapshot of a Python client for the face.com API. It is preserved for historical reference and old integrations, not for active development.

The library wraps face.com endpoints such as faces_detect, faces_recognize, faces_train, tags_save, tags_get, and account/auth helpers. The last documented release in CHANGES is 1.2.3.

Why keep it around?

• It preserves a complete Python wrapper for the old face.com REST API.
• It shows how the client handled signed requests, multipart uploads, and OAuth credentials.
• It includes a longer walkthrough in EXAMPLE.rst.

Installation

This project targets a Python 2-era environment and depends on poster >= 0.4.

pip install poster
python setup.py install

Quick example

import face_client

client = face_client.FaceClient('API_KEY', 'API_SECRET')
response = client.faces_detect(urls='http://example.com/photo.jpg')

print response

If you need user-scoped API calls, the client also supports Facebook and Twitter OAuth credentials:

client.set_facebook_oauth_credentials('FACEBOOK_USER_ID', 'FACEBOOK_OAUTH_TOKEN')
client.set_twitter_oauth_credentials('OAUTH_USER', 'OAUTH_SECRET', 'OAUTH_TOKEN')

Historical references

• EXAMPLE.rst has a longer walkthrough.
• CHANGES contains release notes through version 1.2.3.
• Archived face.com references:
  • API overview (Wayback)
  • Account page (Wayback)
  • Recognition how-to (Wayback)

License

BSD 3-Clause. See LICENSE.