loop-sdk
Connect your robots, cameras, sensors, policies, and teleoperation code to Loop. Your Python application exposes a Node; Loop connects it to a Cell for control and recording.
How Loop uses your Node
Your application owns the device or model code and its execution loop. Loop's Orchestrator applies Config and manages the Node's lifecycle. The Node exchanges application data directly with other Nodes through Ports.
Install
Install the Node SDK for Loop v2 in an isolated environment:
python3 -m venv .venv
source .venv/bin/activate
python -m pip install loop-sdk==0.5.0
python -c 'from loop_sdk import CameraNode, SensorNode, RobotNode'
Installation brings in loop-node[numpy]>=0.2.0,<0.3.0, including NumPy; no
separate NumPy extra is needed on loop-sdk. Release wheels support
CPython 3.10–3.14 on Linux x86_64 and ARM64 (aarch64), with glibc 2.28+.
You also need a compatible running Loop instance to activate Nodes.
Run your first Node
Start with the simulated sensor example. It needs no hardware.
-
Save the file as
sensor_node.py. It connects totcp/127.0.0.1:7448; changeloop_endpointin the file if Loop runs on another host. -
Run your Node:
python sensor_node.py -
In Loop, add
force_sensorto a Cell as an externalloop.sensor@1Node. Config{}uses the defaults. Connect itssensor_observationoutput to Main Controller Node, then click Start Nodes.
The terminal prints Start: sample_hz=50.0, and the Node begins publishing
{"force": 1.25} approximately 50 times per second. Launching the script
connects the Node; Loop configures it, validates connections, then starts publication. Stop Nodes pauses it;
Ctrl+C exits the example.
Node classes and examples
| What your application does | Example |
|---|---|
| Read sensor values | SensorNode |
| Provide camera frames | CameraNode |
| Publish robot state and apply incoming actions | RobotNode |
| Run an existing robot control loop and record its observation/action pairs | RobotStepNode |
| Generate actions with a model | PolicyNode |
| Generate actions through teleoperation | TeleopNode |
Replace each example's simulated or file-backed data with your device or model. See the example setup guide for Node IDs, Config, and compatible examples.
Documentation
| Guide | Use it to |
|---|---|
| Architecture and lifecycle | Understand Nodes, Ports, the Orchestrator, and Configure/Start/Stop |
| Recording flow and data | Follow observations and actions into a recorded episode |
| Node API reference | Look up classes, methods, contracts, and value types |
For SDK development, see CONTRIBUTING.md.
Metadata
Release files for loop-sdk 0.5.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: 3.3 MB
Release files / loop_sdk-0.5.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | loop_sdk-0.5.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 363.0 kB |
| Tags | CPython 3.14 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
e7912a51cf985ac7d06344b9944ae296743e65c17c2a3789c1148bfa22b6816b
|
|
BLAKE2b-256 checksum How to use checksums |
7b37cf2155beeb6014b0c2510744c313f0cef42bfa20cd3101cafc476bc655d8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 16, 2026.
Transparency logRelease files / loop_sdk-0.5.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
| Download URL | loop_sdk-0.5.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 327.9 kB |
| Tags | CPython 3.14 Linux glibc 2.17+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
948762b5cb544422905ef6f9811561d5705c306036f95f50709493a380d798a8
|
|
BLAKE2b-256 checksum How to use checksums |
52554488794fda78922896f2cf3443b0b51628ba25d128ba5a0ad24d52d9c5f3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 16, 2026.
Transparency logRelease files / loop_sdk-0.5.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | loop_sdk-0.5.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 359.1 kB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
223e62b6d7a1a3cda0c1612fcd795ce68b83b60d28da26e6b6ffb81498f6b101
|
|
BLAKE2b-256 checksum How to use checksums |
77c6819128ca2220f073f3b1e4938d6160434aa0e0f1b228d8ffa2bdd2d92f88
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 16, 2026.
Transparency logRelease files / loop_sdk-0.5.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
| Download URL | loop_sdk-0.5.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 324.1 kB |
| Tags | CPython 3.13 Linux glibc 2.17+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
3fb3277e8e80099d03248b7a055cdc5321cdcd162b5e0099d91996478725cb5d
|
|
BLAKE2b-256 checksum How to use checksums |
f3408a5a55a383a131983be8746a235f70b8d7e7ed502754fc4519fc437debe7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 16, 2026.
Transparency logRelease files / loop_sdk-0.5.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | loop_sdk-0.5.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 357.3 kB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
47ed90b00f0bdf56e76d251775de44fd8aecc2a06a6003a41e27d11281dfab08
|
|
BLAKE2b-256 checksum How to use checksums |
46573d4c3468d46fc43065f6d53947a0517efa47b2b7f3120446deecc1a2df8e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 16, 2026.
Transparency logRelease files / loop_sdk-0.5.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
| Download URL | loop_sdk-0.5.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 322.1 kB |
| Tags | CPython 3.12 Linux glibc 2.17+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
66508e4fb1343dff9722eb7ea96aadffc3e376e446338d48ee20ca1ddf8e3004
|
|
BLAKE2b-256 checksum How to use checksums |
87074325481e31af53421db7c4241c7d2f14cb57b39c1de9c36b3b354c38aeca
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 16, 2026.
Transparency logRelease files / loop_sdk-0.5.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | loop_sdk-0.5.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 325.8 kB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
7ea79611cff8958fbb1e27c7a4330137b42d3fa75981174209e39cb977f443f9
|
|
BLAKE2b-256 checksum How to use checksums |
825cbd5033899385853b3f2dcfdc95586f58728322aac47d16883c804f729d29
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 16, 2026.
Transparency logRelease files / loop_sdk-0.5.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
| Download URL | loop_sdk-0.5.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 298.3 kB |
| Tags | CPython 3.11 Linux glibc 2.17+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
fc05064b3b3bd830e507ae6ef5132085f710bcb54d39567239e8f108a0c9ad73
|
|
BLAKE2b-256 checksum How to use checksums |
2d2bd1b23f2ba0cda698af4c61da1a311f6250142b5e39abf18eb369c4a79507
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 16, 2026.
Transparency logRelease files / loop_sdk-0.5.0-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | loop_sdk-0.5.0-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 314.9 kB |
| Tags | CPython 3.10 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
4be5b316ff576a7f901c93580f9e2430abf80c52e12ff6e312121b1cc1e095da
|
|
BLAKE2b-256 checksum How to use checksums |
3a011b5ed7fdf1100773d1a5f175938b500e2b0614d22d0aefa2dc3ee63a8fbd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 16, 2026.
Transparency logRelease files / loop_sdk-0.5.0-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
| Download URL | loop_sdk-0.5.0-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 291.1 kB |
| Tags | CPython 3.10 Linux glibc 2.17+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
d2dc1fcf2e55adeb1d1b22bb1146b8560de74cdd83baa5e1476aa4eee13a3d8e
|
|
BLAKE2b-256 checksum How to use checksums |
5b3842329638896ad306d898ada9d4ca323b613352743123ac23d810a0ef063f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 16, 2026.
Transparency log
