Restora SDK

Python bindings for BrainCo Restora devices.

Installation

pip install restora-sdk

Quick Start

import asyncio

from restora_sdk import (
    GattTransport,
    RESTORA_SERVICE_UUID,
    initialize_central_adapter,
    start_scan_with_uuids,
)


async def main() -> None:
    await initialize_central_adapter()
    await start_scan_with_uuids(
        [RESTORA_SERVICE_UUID],
        GattTransport.Auto,
    )
    await asyncio.sleep(10)


asyncio.run(main())

GattTransport.Auto accepts either Bluetooth LE or GATT over BR/EDR. Use GattTransport.Le or GattTransport.BrEdr to require a specific bearer. BR/EDR devices must be paired first; platform support and prerequisites vary by operating system.

The package also provides connection and sensor streaming APIs (connect_ble, subscribe_eeg, subscribe_imu, and subscribe_ppg), record decoding helpers, and protocol frame builders.

Examples

Example projects and integration guides are maintained in the source repository under sdk/examples/python. Install this package first, then run the example that matches your device and transport mode. OSS credentials used by the record upload example are read from environment variables and are not included in the package.

Support

If you run into device connection or API issues, please share your package version, Python version, operating system, and device model with the SDK maintainer.