smpclient

library7.2.0pypypi✓ verified 83d ago

SMP (Simple Management Protocol) client for remotely managing MCU firmware, based on the MCUmgr protocol. Supports image management, OS management, shell, and file system operations over SMP. Current version: 7.0.0. Release cadence is irregular.

devops communication http-networking

pip install smpclient

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · SMPCLIENT

smpclient

devopspythonv7.2.0

Install

4.9s avg

Import

1268ms

Disk

30MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v7.2.0 · 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

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 1.320s · 31.3MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 4.9s · import 1.216s · 31MB

30MB installed

● package 30MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

SMPClient

✓ from smpclient import SMPClient

Connects to an MCU running an SMP server and retrieves OS info.

import asyncio from smpclient import SMPClient async def main(): async with SMPClient(host='192.168.1.100', port=1337) as client: resp = await client.get_os_info() print(resp) asyncio.run(main())

Debug

Known issues

gotchaDefault port is 1337, but many devices use different ports. Always verify the target's SMP port.

fix

Explicitly pass port=1337 or the correct port when creating SMPClient.

affects: all

gotchaThe library uses asyncio; all operations must be awaited. Calling non-awaited coroutines will raise a RuntimeWarning or hang.

fix

Always use await with SMPClient methods. Run in an async context.

affects: all

deprecatedSMPClient constructor argument 'hostname' is deprecated in favor of 'host'.

fix

Use host='192.168.1.100' instead of hostname='...'.

affects: >=6.0.0

Errors

Common errors & fixes

RuntimeWarning: coroutine 'SMPClient.get_os_info' was never awaited

Calling an async method without await.

fix

Add await before the call: await client.get_os_info()

OSError: [Errno 113] No route to host

Cannot connect to the target device; wrong IP or device not reachable.

fix

Verify the device IP and that the SMP server is running. Check firewall rules.

Upgrade

Version history

7.2.0latest on PyPI · released Jun 11, 2026

Audit

Dependencies

cbor2requiredCBOR serialization for SMP messages

Agent activity

23 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/intercreate/smpclient ↗

packagehttps://pypi.org/project/smpclient/ ↗

homepagehttps://www.intercreate.io ↗

docshttps://intercreate.github.io/smpclient ↗