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.
- You might get
- 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 ensurepippython -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/distfolder. - 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)
Total release size: 10.1 MB
Release files / cerelink-8.1.0-cp313-cp313-win_arm64.whl
| Download URL | cerelink-8.1.0-cp313-cp313-win_arm64.whl |
|---|---|
| Size | 162.1 kB |
| Tags | CPython 3.13 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
68d07e70bf35fe5765c05787106ebc814c9a221d0b610cbff51562bc1ee876d3
|
|
BLAKE2b-256 checksum How to use checksums |
7e57d50f61afd9b429f217316022006b42a5b86a932b2883f1e0323614262d9d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 25, 2025.
Transparency logRelease files / cerelink-8.1.0-cp313-cp313-win_amd64.whl
| Download URL | cerelink-8.1.0-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 183.6 kB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
17d7ce3e97dbf96699f4cf007b783b9d71b9f552efcfd99d4dd5751de3080c23
|
|
BLAKE2b-256 checksum How to use checksums |
adffc5703235a4b44c7e7d0a52ad4a72ebe1be7cf8d04177193bf7edc6b32a3e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 25, 2025.
Transparency logRelease files / cerelink-8.1.0-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
| Download URL | cerelink-8.1.0-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.13 Linux glibc 2.24+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
6f1ba43fa4dcc92d795e5f92b79e3694ce9994dc5bce6882728371537bea219d
|
|
BLAKE2b-256 checksum How to use checksums |
06502df522166f7736c62b0d0e062a1be43494fac5c5eb198c35ccb93ebdf731
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 25, 2025.
Transparency logRelease files / cerelink-8.1.0-cp313-cp313-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl
| Download URL | cerelink-8.1.0-cp313-cp313-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.13 Linux glibc 2.24+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
f17b03ce1eea0c7867c23a8f2c09c7ea22a6ee44ab45d481da59dc3cbe2dbde1
|
|
BLAKE2b-256 checksum How to use checksums |
e883cfe7933544f223b5c26c0ba61f871ac66918869d40640a9b3db3f26f254a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 25, 2025.
Transparency logRelease files / cerelink-8.1.0-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | cerelink-8.1.0-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 389.9 kB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
86b78203c8263317fafb99eb37abe8dc4cbb5b638daef24f4837dac9b4b3bae6
|
|
BLAKE2b-256 checksum How to use checksums |
031cd52fe66ea7a72350ff7a403fc0f4a83258d2fe3d2c59f71edd64a564b61c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 25, 2025.
Transparency logRelease files / cerelink-8.1.0-cp312-cp312-win_arm64.whl
| Download URL | cerelink-8.1.0-cp312-cp312-win_arm64.whl |
|---|---|
| Size | 162.4 kB |
| Tags | CPython 3.12 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
d216df7bc3d905c422c3e5aa9a2583d132c8771c1578c471b84c93a0684a2e2a
|
|
BLAKE2b-256 checksum How to use checksums |
3fee8405bde3da7e503ef0af0e191c82948a980c92efd94bf7be60be77debd29
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 25, 2025.
Transparency logRelease files / cerelink-8.1.0-cp312-cp312-win_amd64.whl
| Download URL | cerelink-8.1.0-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 183.6 kB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
b2749676641e44f3d80c27648f625bfdb6ac3b39fca2061e9838e92eaaa43a54
|
|
BLAKE2b-256 checksum How to use checksums |
7bc9e8650b0071c4522702bf9ee8511bd1f1de34047097d850104522c82960da
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 25, 2025.
Transparency logRelease files / cerelink-8.1.0-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
| Download URL | cerelink-8.1.0-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.12 Linux glibc 2.24+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
a87a5949db4c20f796751534581acbbe42a0106029d8ecdff538917ba0ad640d
|
|
BLAKE2b-256 checksum How to use checksums |
59cebe6108e587bac3c93e221fa493aa3490472d0aa1f68b38a9451090f5121e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 25, 2025.
Transparency logRelease files / cerelink-8.1.0-cp312-cp312-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl
| Download URL | cerelink-8.1.0-cp312-cp312-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.12 Linux glibc 2.24+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
5009e6116b5ead16458549c71d4c452c003015730d14ba84417dc352e7917f20
|
|
BLAKE2b-256 checksum How to use checksums |
1a5fb3e5bb343ffbfd3701bd6902e3ace434bd5e04da6fd75adade11bb8955f0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 25, 2025.
Transparency logRelease files / cerelink-8.1.0-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | cerelink-8.1.0-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 391.0 kB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
479b0970cca9aa970d67c6d5fd58a80f4ad818c15b92e1344e06a0245ded61a0
|
|
BLAKE2b-256 checksum How to use checksums |
7a3eb90b71fd0548f7d5e43895c0a7258dedda63b619ab498af448368b96a2c9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 25, 2025.
Transparency logRelease files / cerelink-8.1.0-cp311-cp311-win_arm64.whl
| Download URL | cerelink-8.1.0-cp311-cp311-win_arm64.whl |
|---|---|
| Size | 164.6 kB |
| Tags | CPython 3.11 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
17ad67c77bf2b91b8d550b9708511efb258c4935d5de152282b81fce92483d1f
|
|
BLAKE2b-256 checksum How to use checksums |
294f8a3e54dc0212da67fde05cc3efe8591df66ee65a8a1319bf1e92759d1623
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 25, 2025.
Transparency logRelease files / cerelink-8.1.0-cp311-cp311-win_amd64.whl
| Download URL | cerelink-8.1.0-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 184.8 kB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
9e101a67cbe51478ea57f4c8ca81b34b942adf22c6d53112df1b5b00a808a58b
|
|
BLAKE2b-256 checksum How to use checksums |
7921eb8f0b8cd6aed27786bebda08e70ecab3ddce83e525efe233abf0884f84f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 25, 2025.
Transparency logRelease files / cerelink-8.1.0-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
| Download URL | cerelink-8.1.0-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 1.4 MB |
| Tags | CPython 3.11 Linux glibc 2.24+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
4df6e4e52b73cb622ec60f7de4ce789da56ad040224fdbbefb6bf5ab99dde463
|
|
BLAKE2b-256 checksum How to use checksums |
699018a31f9651d6228afcd79cd9f00a7aa036eb4c87988afe94d265ecfea98e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 25, 2025.
Transparency logRelease files / cerelink-8.1.0-cp311-cp311-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl
| Download URL | cerelink-8.1.0-cp311-cp311-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.11 Linux glibc 2.24+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
ad75b42e072adcf8d3be0f90b56832497c3899c336fea6fc53da2c4381c9feae
|
|
BLAKE2b-256 checksum How to use checksums |
ead1fb94bd8aa3e561927e087b2de872418d4c685e47f56d908bbe49f6d41a8b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 25, 2025.
Transparency logRelease files / cerelink-8.1.0-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | cerelink-8.1.0-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 391.9 kB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
551e06cd44f18e44cb1b5ba8d067325169428ae5a18bbfde8d8c615a4754fc1c
|
|
BLAKE2b-256 checksum How to use checksums |
badbcc85155a5eb7376fb333da8d09b88f613547770661d9d872d615d2d9de11
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 25, 2025.
Transparency log