Adelpha

Python library for Adelpha MRI: connect sensors, run control handlers, and call Engineering Studio design functions.

pip install adelpha

from adelpha import telemetry, feedback

Adelpha is the WebSocket server. Your Raspberry Pi, or a Python process that talks to an Arduino, is the client. Arduino never opens a serial session to Adelpha.

Telemetry (sensors)

import asyncio
import os

from adelpha import telemetry

client = telemetry.connect(
    os.environ["ADELPHA_URL"],
    os.environ["ADELPHA_DEVICE_ID"],
    os.environ["ADELPHA_DEVICE_TOKEN"],
)


async def acquire(device):
    while True:
        await telemetry.publish(
            device,
            temperature=[
                {
                    "sensor_id": 1,
                    "value": 28.4,
                    "unit": "degC",
                    "role": "magnet",
                    "quality": "valid",
                }
            ],
        )
        await asyncio.sleep(1)


asyncio.run(client.run(acquire))

ADELPHA_URL is ws://<host>:8765/ws/<device_id>. Put the token in the environment, never in the URL. Missing sensors use value: null with quality missing or invalid, never zero.

Feedback (control)

from adelpha import feedback, telemetry

client = telemetry.DeviceClient(
    os.environ["ADELPHA_URL"],
    os.environ["ADELPHA_DEVICE_ID"],
    os.environ["ADELPHA_DEVICE_TOKEN"],
    journal_path="./commands.sqlite3",
)


@feedback.register(
    client,
    "cooling-01",
    "set_enabled",
    argument_schema={
        "type": "object",
        "properties": {"enabled": {"type": "boolean"}},
        "required": ["enabled"],
        "additionalProperties": False,
    },
)
async def cooling(enabled):
    return {"enabled": enabled}

Adelpha rejects actuator commands until a hardware scanner profile is selected, allow_control is true in devices.json, and Settings → Devices → Physical control is on. Device-local interlocks remain authoritative.

Other modules

Optional extras: adelpha[twin], adelpha[agents], adelpha[pinn].

The imaging console is not part of this package.

Publish (maintainers)

From the repository root, after tests pass:

uv build
uv publish

Or python -m build and twine upload dist/*.