Human Interaction API


License
MIT
Install
pip install people==0.1.1

Documentation

People API

people is an API for requesting human intervention.

Installation

pip install people

Getting Started

>>> import people

Connecting

>>> people.User.create('example@email.com', 'example_username', 'example_password')

>>> people.username = 'example_username'
>>> people.password = 'example_password'

Funding Your Account

Payment info is completely handled by Stripe, ensuring your payment security.

To deposit funds, login and visit https://people-api-server.herokuapp.com/checkout/?amount=DESIRED_DEPOSIT_AMOUNT

You should see your balance afterwards within your profile.

Creating Queries

>>> people.Query.create(
    "Translate the following sentence to English: Qui n'avance pas, recule."
)

>>> people.Query.create(
    "How many cars are in this image? https://imgur.com/...",
    people.regex.NONNEG_INT
)

>>> people.Query.create(
    "Is this an image of a [cat], a [dog], or [neither]? https://imgur.com/...",
    people.regex.union('cat', 'dog', 'neither')
)

>>> people.Query.create(
    "How positive is this article on a scale from 1 to 5? https://...",
    r'[1-5]'
)

Creating Responses

>>> query = people.Query.get() 

>>> query['text']

"How many cars are in this image? https://imgur.com/...",

>>> query['regex']

r'd+'

>>> response = people.Response.create('Not sure.', query['id'])

coreapi.exceptions.ErrorMessage: <Error: 400 Bad Request>
    non_field_errors: [
    "Response text 'Not sure.' does not match query regex r'd+'"
]

>>> response = people.Response.create('3', query['id'])