Metadata-Version: 2.1
Name: hume
Version: 0.1.2
Summary: Hume AI Python Client
Home-page: https://github.com/HumeAI/hume-python-sdk
License: Proprietary
Keywords: hume,expressive,communication,audio,recognition,ai,analysis,detection,voice,sentiment,emotion
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: requests (>=2.26.0,<3.0.0)
Requires-Dist: typing-extensions (>=4.3.0,<5.0.0)
Project-URL: Repository, https://github.com/HumeAI/hume-python-sdk
Description-Content-Type: text/markdown

# Hume AI Python SDK

The Hume AI Python SDK 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 HumeBatchClient

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

job_id = "<your-job-id>"
job = client.get_job(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 SDK please [open an issue](https://github.com/HumeAI/hume-python-sdk/issues/new)!

