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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file calimero_client_py-0.6.21.tar.gz.
File metadata
- Download URL: calimero_client_py-0.6.21.tar.gz
- Upload date:
- Size: 53.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
86d91cae61751a7728f76381a6d74676a30ee1e3bc0c42c8ab4479ac528a4653
|
|
| MD5 |
3279436c639fc1671860f9b970921ade
|
|
| BLAKE2b-256 |
a7a97592a7b774ee15286449a0e0406615bbbb8181022ac8322241a1b2e54a41
|
Provenance
The following attestation bundles were made for calimero_client_py-0.6.21.tar.gz:
Publisher:
build-wheels.yml on calimero-network/calimero-client-py
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
calimero_client_py-0.6.21.tar.gz -
Subject digest:
86d91cae61751a7728f76381a6d74676a30ee1e3bc0c42c8ab4479ac528a4653 - Sigstore transparency entry: 2339316607
- Sigstore integration time:
-
Permalink:
calimero-network/calimero-client-py@24c3b9964159ce62b29946c6df2fb4b7330cafa6 -
Branch / Tag:
refs/heads/master - Owner: https://github.com/calimero-network
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
build-wheels.yml@24c3b9964159ce62b29946c6df2fb4b7330cafa6 -
Trigger Event:
push
-
Statement type:
