reeve-python-sdk 0.1.0

Python SDK for the Reeve API - A facial recognition service for person identification and verification

reeve_python_sdk

Python SDK for the Reeve API - A facial recognition service for person identification and verification.

This SDK provides a Python interface to interact with the Reeve API, enabling facial recognition capabilities including person management, face enrollment, face recognition, and face verification.

Features

• Authentication - Token-based authentication with Bearer JWT

• Person Management - Create, list, update, and delete persons

• Face Management - Add, list, and delete face images for persons

• Face Recognition - Identify unknown faces against enrolled persons

• Face Verification - Verify faces against specific persons or compare two faces

Installation

pip install reeve_python_sdk

Development Installation

git clone https://github.com/qbit-codes/reeve-python-sdk.git
cd reeve-python-sdk
pip install -e .

Quick Start

import asyncio
from reeve_python_sdk import ReeveClient

async def main():
    async with ReeveClient(
        api_url="https://api.reeve.example.com",
        api_key="your-api-key"
    ) as client:
        # Create a person
        person = await client.person.add(firstname="John", lastname="Doe")
        person_id = person["result"]["id"]

        # Add a face to the person
        with open("face.jpg", "rb") as f:
            await client.face.add(person_id=person_id, face=f)

        # Recognize a face
        with open("unknown_face.jpg", "rb") as f:
            result = await client.face.recognize(face=f)
            if result.get("result"):
                print(f"Recognized: {result['result']['name']}")

asyncio.run(main())

API Documentation

Full API specification is available in docs/swagger.json.

Testing

Run tests with:

pytest

Or with tox for comprehensive testing:

tox

Note

This project has been set up using PyScaffold 4.6. For details and usage information on PyScaffold see https://pyscaffold.org/.