Skip to main content

cerelink

This is a Python wrapper for the CereLink (cbsdk) library to configure, pull data, and receive callbacks from Blackrock Neurotech devices.

Note: If you do not require Central running on the same computer as your Python Blackrock device client, then consider instead using pycbsdk.

Getting Started

  • Download a wheel from the releases page or build it yourself.
  • Activate a Python environment with pip, Cython, and numpy
  • Install the wheel: python -m pip install path\to\filename.whl
  • Test with python -c "from cerelink import cbpy; cbpy.open(parameter=cbpy.defaultConParams())"
    • You might get RuntimeError: -30, Instrument is offline.. That's OK, depending on your device and network settings.
  • See cerebuswrapper for a tool that provides a simplified interface to cerelink.

Build Instructions

  • If you haven't already, build and install CereLink following the main BUILD instructions.
    • Windows: If using Visual Studio then close it.
  • Open a Terminal or Anaconda prompt and activate your Python environment.
  • Your Python environment's Python interpreter (CPython, arch, version) must match that of the eventual machine that will run the package, and it must already have Cython, numpy, pip, setuptools, and wheel installed.
    • We do not set these as explicit dependencies on the package to avoid bundling them so you must install manually.
    • python -m ensurepip
    • python -m pip install --upgrade pip setuptools wheel cython numpy
  • Change to the CereLink directory.
  • Install locally: python -m pip install bindings/Python
  • or, if you are making a wheel to bring to another machine,
    • activate an environment matching the target machine,
    • python -m pip wheel bindings/Python -w bindings/Python/dist
    • The wheels will be in the bindings/Python/dist folder.
    • See the Wiki for more information.

NumPy Compatibility

This project is built against NumPy 2.x. Users must have NumPy 2.0 or later installed. If you are having trouble, try to run the following command and report your results: python -c "import numpy; print(f'NumPy: {numpy.__version__}'); from cerelink import cbpy; print('Success!')"

If you need to support older NumPy 1.x versions, you can build wheels with:

[build-system]
requires = ["setuptools", "wheel", "cython", "oldest-supported-numpy", "setuptools-scm"]

[project]
dependencies = [
  "numpy>=1.23.0,<2.0",
]

Metadata

Release files for cerelink 8.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for cerelink 8.1.0
File
cerelink-8.1.0-cp313-cp313-win_arm64.whl CPython 3.13 CPython 3.13 Windows ARM64 Details
cerelink-8.1.0-cp313-cp313-win_amd64.whl CPython 3.13 CPython 3.13 Windows x86-64 Details
cerelink-8.1.0-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl CPython 3.13 CPython 3.13 Linux glibc 2.28+ x86-64, Linux glibc 2.24+ x86-64 Details
cerelink-8.1.0-cp313-cp313-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl CPython 3.13 CPython 3.13 Linux glibc 2.24+ ARM64, Linux glibc 2.28+ ARM64 Details
cerelink-8.1.0-cp313-cp313-macosx_11_0_arm64.whl CPython 3.13 CPython 3.13 macOS 11.0+ ARM64 Details
cerelink-8.1.0-cp312-cp312-win_arm64.whl CPython 3.12 CPython 3.12 Windows ARM64 Details
cerelink-8.1.0-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details
cerelink-8.1.0-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.28+ x86-64, Linux glibc 2.24+ x86-64 Details
cerelink-8.1.0-cp312-cp312-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl CPython 3.12 CPython 3.12 Linux glibc 2.24+ ARM64, Linux glibc 2.28+ ARM64 Details
cerelink-8.1.0-cp312-cp312-macosx_11_0_arm64.whl CPython 3.12 CPython 3.12 macOS 11.0+ ARM64 Details
cerelink-8.1.0-cp311-cp311-win_arm64.whl CPython 3.11 CPython 3.11 Windows ARM64 Details
cerelink-8.1.0-cp311-cp311-win_amd64.whl CPython 3.11 CPython 3.11 Windows x86-64 Details
cerelink-8.1.0-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.28+ x86-64, Linux glibc 2.24+ x86-64 Details
cerelink-8.1.0-cp311-cp311-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl CPython 3.11 CPython 3.11 Linux glibc 2.24+ ARM64, Linux glibc 2.28+ ARM64 Details
cerelink-8.1.0-cp311-cp311-macosx_11_0_arm64.whl CPython 3.11 CPython 3.11 macOS 11.0+ ARM64 Details

Total release size: 10.1 MB

Release history Release notifications | RSS feed

This release

8.1.0 This release

15 release files

8.0.2

10 release files

8.0.1

10 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page