Simple Management Protocol (SMP) Client

smpclient implements the transport layer of the Simple Management Protocol. This library can be used as a dependency in applications that use SMP over serial (UART or USB), Bluetooth (BLE), or UDP connections. Some abstractions are provided for common routines like upgrading device firmware.

If you don't need a library with the transport layer implemented, then you might prefer to use smp instead. The SMP specification can be found here.

If you'd like an SMP CLI application instead of a library, then you should try smpmgr.

Install

smpclient is distributed by PyPI and can be installed with poetry, pip, and other dependency managers.

User Documentation

Documentation is in the source code so that it is available to your editor. An online version is generated and available here.

Development Quickstart

Assumes that you've already setup your development environment.

activate envr, the environment manager for bash, zsh, and PS:
```
. ./envr.ps1
```
run poetry install when pulling in new changes
run lint after making changes
run test after making changes
add library dependencies with poetry:
```
poetry add <my_new_dependency>
```
add test or other development dependencies using poetry groups:
```
poetry add -G dev <my_dev_dependency>
```
run tests for all supported python versions:
```
tox
```

Development Environment Setup

Install Dependencies

poetry: https://python-poetry.org/docs/#installation

Create the venv

poetry install

The venv should be installed to .venv.

Activate envr

envr supports bash, zsh, and PS in Linux, MacOS, and Windows. If you are using an unsupported shell, you can activate the .venv environment manually, use poetry run and poetry shell, and refer to envr-default for useful aliases.

. ./envr.ps1

Verify Your Setup

To verify the installation, make sure that all of the tests are passing using these envr aliases:

lint
test

Enable the githooks

The pre-commit hook will run the linters but not the unit tests.

git config core.hooksPath .githooks

Metadata

Release files for smpclient 5.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for smpclient 5.2.0
File	Size	Uploaded
smpclient-5.2.0.tar.gz	25.8 kB	Nov 14, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for smpclient 5.2.0
File	Interpreter	ABI	Platform	Reset
smpclient-5.2.0-py3-none-any.whl 32.1 kB Nov 14, 2025	Python 3	none	any	Details

Total release size: 58.0 kB

Release files / smpclient-5.2.0.tar.gz

Download URL	smpclient-5.2.0.tar.gz
Size	25.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`41ceaa883ade9be5148ceb6bee8671da0cf9359dd770e6f8b11203cd4b34d1ee`
BLAKE2b-256 checksum How to use checksums	`4ebf72bd52ce6d6f6ff6c3e0dd0d09083b8376a5a57fd3cffe4f085e07a83d43`
Upload date	Nov 14, 2025
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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/intercreate/smpclient
Publishing commit: github.com/intercreate/smpclient/tree/625e1f03a3256dff0daa56b3b7251cb05ff175b4

Workflow

Publishing configuration: github.com/intercreate/smpclient/blob/625e1f03a3256dff0daa56b3b7251cb05ff175b4/.github/workflows/release.yaml
Publishing logs: github.com/intercreate/smpclient/actions/runs/19379177546/attempts/1

Artifact

Subject: smpclient-5.2.0.tar.gz
SHA-256 checksum: 41ceaa883ade9be5148ceb6bee8671da0cf9359dd770e6f8b11203cd4b34d1ee Verifying attestations

Release files / smpclient-5.2.0-py3-none-any.whl

Download URL	smpclient-5.2.0-py3-none-any.whl
Size	32.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`6dde499a1e657cc1c6823fd4c7bac1099cb817035cd521b8a078795f03ee77e2`
BLAKE2b-256 checksum How to use checksums	`313821dc06a8eb398e5f22c7ec0b4f9812870ba579ab3100d329e83e037cd0c3`
Upload date	Nov 14, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/intercreate/smpclient
Publishing commit: github.com/intercreate/smpclient/tree/625e1f03a3256dff0daa56b3b7251cb05ff175b4

Workflow

Publishing configuration: github.com/intercreate/smpclient/blob/625e1f03a3256dff0daa56b3b7251cb05ff175b4/.github/workflows/release.yaml
Publishing logs: github.com/intercreate/smpclient/actions/runs/19379177546/attempts/1

Artifact

Subject: smpclient-5.2.0-py3-none-any.whl
SHA-256 checksum: 6dde499a1e657cc1c6823fd4c7bac1099cb817035cd521b8a078795f03ee77e2 Verifying attestations