Install & Compatibility
Where this runs
tested against v1.15.1 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.858s · 100MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 5.4s · import 0.840s · 96MB
100MB installed
● package 100MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
RunEngine
✓ from bluesky import RunEngine
✗ from bluesky.run_engine import RunEngine
RunEngine is at the top-level, not in a submodule.
Plan
✓ from bluesky import plan as bp
✗ from bluesky.plan import bp
The standard convention is to import the 'plans' module as 'bp'.
Msgen
✓ from bluesky import msg
✗ from bluesky.message import Msg
Message objects are accessed via `bluesky.msg.Msg`, not a separate message module.
Instantiates a RunEngine, defines a dummy detector (callable returning a dict), and executes a count plan with a live table callback.
from bluesky import RunEngine
from bluesky.plans import count
from bluesky.callbacks import LiveTable
RE = RunEngine()
def detector():
return {'det': 1}
RE(count([detector()])
Errors
Common errors & fixes
TypeError: __init__() got an unexpected keyword argument 'plan'
Passing a plan to RE() incorrectly; RE expects a plan as the first argument, but user tried `RE(plan=my_plan)`.
fixCall `RE(my_plan)` instead of `RE(plan=my_plan)`.
AttributeError: module 'bluesky' has no attribute 'RunEngine'
Incorrect import or older bluesky version (<0.10) where RunEngine was in a different location.
fixEnsure bluesky>=0.10 and use `from bluesky import RunEngine`.
ValueError: The truth value of an array with more than one element is ambiguous
Passing a numpy array where a scalar is expected, e.g., as a motor setpoint in a plan.
fixEnsure setpoints are scalars (float/int) and not arrays; use `float(value)` if necessary.
Upgrade
Version history
1.15.1latest on PyPI · released May 6, 2026
Audit
Dependencies
event-modelrequiredProvides document schema for event streams.
matplotliboptionalOptional live plotting callbacks.
ophydoptionalHardware abstraction layer (devices).
tiledoptionalData access library for Tiled servers (used in TiledWriter).