Metadata-Version: 2.1
Name: hume
Version: 0.1.0
Summary: Hume AI Python Client
Home-page: https://github.com/HumeAI/python-client
License: Proprietary
Keywords: hume,ai,client,sdk
Author: Hume AI Dev
Author-email: dev@hume.ai
Requires-Python: >=3.8,<3.10
Classifier: Development Status :: 4 - Beta
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: backoff (>=2.1.2,<3.0.0)
Requires-Dist: requests (>=2.26.0,<3.0.0)
Requires-Dist: typing-extensions (>=4.3.0,<5.0.0)
Project-URL: Repository, https://github.com/HumeAI/python-client
Description-Content-Type: text/markdown

# Hume AI Python Client

The Hume AI Python client makes it easy to call Hume APIs from Python applications.

To get started, [sign up for a Hume account](https://beta.hume.ai/sign-up)!

## Requirements

Python versions between 3.8 and 3.10 are supported

## Installation

```
pip install hume
```

## Example Usage

### Submit a new batch job

> Note: Your personal API key can be found in the profile section of [beta.hume.ai](https://beta.hume.ai)

```python
from hume import HumeBatchClient

client = HumeBatchClient("<your-api-key>")
urls = ["https://tinyurl.com/hume-img"]
job = client.submit_face(urls)

print(job)
print("Running...")

result = job.await_complete()
result.download_predictions("predictions.json")

print("Predictions downloaded!")
```

### Rehydrate a batch job from a job ID

```python
from hume import BatchJob, HumeBatchClient

client = HumeBatchClient("<your-api-key>")

job_id = "<your-job-id>"
job = BatchJob(client, job_id)

print(job)
```

## Documentation

Learn more about Hume's expressive communication platform on [our homepage](https://hume.ai) or our [platform docs](https://help.hume.ai/basics/about-hume-ai)

See example requests and responses for all available endpoints in the [Hume API Reference](https://docs.hume.ai)

## Support

If you've found a bug with this client please [open an issue](https://github.com/HumeAI/python-client/issues/new)!

