Metadata-Version: 2.1
Name: HABSlib
Version: 0.1.54
Summary: A library for interacting with the HABS BrainOS API.
Home-page: https://github.com/Olocufier/HABS.git
Author: Domenico Guarino
Author-email: domenico@habs.ai
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENCE
Requires-Dist: asyncio ==3.4.3
Requires-Dist: brainflow ==5.12.1
Requires-Dist: numpy ==1.26.4
Requires-Dist: requests ==2.31.0
Requires-Dist: scipy ==1.13.0
Requires-Dist: urllib3 ==2.2.1
Requires-Dist: jsonschema
Requires-Dist: cryptography ==42.0.8
Requires-Dist: pytest
Requires-Dist: pytest-html
Requires-Dist: pytest-order
Requires-Dist: pytest-dependency
Requires-Dist: pdoc
Requires-Dist: pyEDFlib
Requires-Dist: matplotlib

[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/Olocufier/HABSlib/HEAD)
# HABSlib

A Python library for interacting with the HABS BrainOS API, to manage EEG recordings, handling complexities like encryption, authentication, and more, so you can focus on building your application.

Please, consider reading (and providing feedback about) our online [documentation](https://olocufier.github.io/HABSlib/HABSlib/service.html).


## Installation

You can install habslib using pip:

```
pip install HABSlib
```

## Usage

Here’s a quick example to get you started:

```
import HABSlib as hb

###############
# Security handshake
hb.handshake(base_url="http://habs", user_id="your_id_from_habs")

###############
# Get user data by id
user_data = hb.get_user_by_id(user_id)
print(user_data)

# ###############
# Simple sending data
session_id = hb.acquire_send_raw(
    user_id=user_id, 
    date=datetime.today().strftime('%Y-%m-%d'), 
    board="SYNTHETIC",
    stream_duration=20, 
    buffer_duration=5
)
print("this session:", session_id)
```

## Contributing

We welcome contributions! Please see our CONTRIBUTING.md for more details.

## License

This project is licensed under the MIT License - see the LICENSE file for details.

## Contact

If you have any questions or need support, please open an issue on GitHub or contact dev@habs.ai.
