Calimero Client Python Library
A Python client SDK for Calimero Network, backed by a native Rust core via PyO3. Connect to a node, manage applications and contexts, move blobs, administer namespaces and groups, and call your app's methods over JSON-RPC — all from synchronous Python.
Documentation
Full documentation is published at
https://calimero-network.github.io/calimero-client-py/ — installation,
quickstart, task guides, and the complete Python API reference. The source lives
under docs/.
Installation
pip install calimero-client-py
The package is published as a source distribution (no prebuilt wheels), so
installing compiles the native Rust extension on your machine. You need a Rust
toolchain on PATH — install one with rustup if you don't
already have cargo. Python 3.9+ is required. See the
installation guide
for details.
Quick start
Every Client method is synchronous: it blocks until the node responds and
returns a plain Python value (a dict, list, bytes, or scalar). There are no
coroutines and nothing to await.
from calimero_client_py import create_connection, create_client
connection = create_connection(
api_url="http://localhost:2428",
node_name="local-dev", # stable name; used for the token cache
)
client = create_client(connection)
print("connected to", client.get_api_url())
contexts = client.list_contexts()
print(f"found {len(contexts)} contexts")
# call a method on the app running in a context (args is a JSON string)
result = client.execute_function(
context_id="<context-id>",
method="set",
args='{"key": "greeting", "value": "hello"}',
)
print(result)
See the quickstart and guides for connecting, authentication, contexts, blobs, and namespaces & groups.
CLI
Installing the package puts a small calimero-client-py command on your PATH
for quick checks:
calimero-client-py --version
calimero-client-py --base-url http://localhost:2428 list-contexts
See the CLI reference.
Development
Build from source with maturin:
pip install maturin
maturin develop --release # compile the extension into the active venv
python -c "import calimero_client_py; print('ok', calimero_client_py.VERSION)"
Run the tests:
cargo test # Rust unit tests
pytest # Python tests
The Rust core depends on Calimero crates pulled from
github.com/calimero-network/core,
so the first build fetches and compiles those too (a network connection is
required for the initial build).
Support
- Documentation: https://calimero-network.github.io/calimero-client-py/
- Issues: https://github.com/calimero-network/calimero-client-py/issues
- Contact: team@calimero.network
License
See LICENSE.
1 maintainer
Release files for calimero-client-py 0.7.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| calimero_client_py-0.7.0.tar.gz | 61.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| calimero_client_py-0.7.0-cp313-cp313-win_amd64.whl | CPython 3.13 | CPython 3.13 | Windows x86-64 | Details |
Total release size: 1.6 MB
Release files / calimero_client_py-0.7.0.tar.gz
| Download URL | calimero_client_py-0.7.0.tar.gz |
|---|---|
| Size | 61.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b0e095cd8bea420d514681fd979a7ea0450db57a13fdf5d0edd63d775c1dc619
|
|
BLAKE2b-256 checksum How to use checksums |
636c80825a0a2a0465df493af909b8709f8af70768101c216b5d315d90dddd15
|
| 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 2, 2026.
Transparency logRelease files / calimero_client_py-0.7.0-cp313-cp313-win_amd64.whl
| Download URL | calimero_client_py-0.7.0-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 1.6 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
bcea715f7fbae43b3c53ed3a7bd3d089bcd01977026716c1802cfa27618b3af6
|
|
BLAKE2b-256 checksum How to use checksums |
8a957aeca49eaaf5978ec6cb4285302f96bfac337a6565fe223e93b960170498
|
| 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 2, 2026.
Transparency log
