/vws-python

Python wrapper for Vuforia Web Services (VWS) API

Primary LanguagePythonMIT LicenseMIT

Build Status codecov PyPI Documentation Status

vws-python

Python library for the Vuforia Web Services (VWS) API and the Vuforia Web Query API.

Installation

pip install vws-python

This is tested on Python 3.9+. Get in touch with adamdangoor@gmail.com if you would like to use this with another language.

Getting Started

import io

from vws import VWS, CloudRecoService

server_access_key = '[server-access-key]'
server_secret_key = '[server-secret-key]'
client_access_key = '[client-access-key]'
client_secret_key = '[client-secret-key]'

vws_client = VWS(
    server_access_key=server_access_key,
    server_secret_key=server_secret_key,
)
cloud_reco_client = CloudRecoService(
    client_access_key=client_access_key,
    client_secret_key=client_secret_key,
)
name = 'my_image_name'

with open('/path/to/image.png', 'rb') as my_image_file:
   my_image = io.BytesIO(my_image_file.read())

target_id = vws_client.add_target(
    name=name,
    width=1,
    image=my_image,
    active_flag=True,
    application_metadata=None,
)
vws_client.wait_for_target_processed(target_id=target_id)
matching_targets = cloud_reco_client.query(image=my_image)

assert matching_targets[0].target_id == target_id

Full Documentation

See the full documentation.