MESH ONLINECODENAME:
v0.34

Python SDK

Install the Python SDK for capability discovery, tool calls, event streams, and artifact transfer:

shell
pip install net-mesh-sdk

The package installs as net-mesh-sdk and imports as net_sdk. The native net-mesh binding is installed transitively.

Choose the entry point

  • NetNode is the event bus. Transport is selected in the constructor; memory is the default.
  • MeshNode provides the ergonomic tool surface through serve_tool, call_tool, and list_tools.

Python exposes the raw capability announce/query surface through the node's native handle rather than the same MeshNode methods used for tools. The pages below use the ergonomic path and identify the places that require the native handle.

Protected services

Both authority surfaces live on the native net package: organization auth (serve_org_typed, TypedOrgClientconcepts) and the subnet authority plane (concepts) — mesh.serve_subnet_exported(service, export_name, handler) for a provider inside a protected subnet, client.call_exported(service, request) for the caller, and net.subnet.admin.* for runtime gateway administration. Named exports and trust anchors are constructor kwargs (subnet_exports=, subnet_authorities=, …) validated before the node exists; subnet:<kind> failures classify through net.subnet.classify_subnet_error (reference).

Follow the capability path

  1. Quickstart
  2. Announce
  3. Discover
  4. Invoke
  5. Watch
  6. Artifacts
  7. Errors