Pre-release

This release is a pre-release and may not be stable for production use.

agentic-mesh-protocol

Python gRPC interfaces for the Agentic Mesh Protocol.

Installation

pip install agentic-mesh-protocol

Overview

This package provides Python interfaces generated from Agentic Mesh Protocol Buffer definitions, enabling seamless integration with agentic mesh services via gRPC.

Usage

Basic Import

import agentic_mesh_protocol
from agentic_mesh_protocol.module.v1 import information_pb2, module_service_pb2_grpc

Working with gRPC Services

Example for connecting to a gRPC service:

import grpc
from agentic_mesh_protocol.module.v1 import module_service_pb2_grpc
from agentic_mesh_protocol.module.v1 import information_pb2

# Create a gRPC channel and client stub
channel = grpc.insecure_channel('localhost:50051')
stub = module_service_pb2_grpc.ModuleServiceStub(channel)

# Create a request object
request = information_pb2.GetModuleInputRequest(
    module_id="my-module-id"
)

# Call the service
response = stub.GetModuleInput(request)
print(response)

Development

Prerequisites

Python 3.10+
uv - Modern Python package management
Task - Task runner
rsync - For copying generated files

Note: buf and protoc are handled by the submodule via npx, no local installation needed

Setup Development Environment

# Clone the repository with submodules
git clone --recurse-submodules https://github.com/DigitalKin-ai/service-apis-py.git
cd service-apis-py

# Setup development environment
task setup

# Or use the quick dev setup command
task dev

Local Installation & Testing

To test the package locally before publishing:

# Install the package in editable mode
uv pip install -e .

# Or with pip
pip install -e .

# Run the local test script
python test_local.py

To test the package in an isolated environment (simulates a fresh install):

# Using uv (recommended)
uv run --with . --no-project -- python test_local.py

# Or create a fresh venv
python -m venv /tmp/test-amp
source /tmp/test-amp/bin/activate
pip install .
python test_local.py
deactivate
rm -rf /tmp/test-amp

Common Development Tasks

# Generate Python code from protobuf definitions
task gen

# Build the package
task build

# Run tests
task test

# Format code
task fmt

# Lint code
task lint

# Clean build artifacts
task clean

# Bump version
task bump-version -- patch
task bump-version -- minor
task bump-version -- major

Publishing Process

Update code and commit changes
Use the GitHub "Create Release" workflow to bump version (patch, minor, major)
The workflow will automatically create a new release and publish to PyPI

License

This project is licensed under the terms specified in the LICENSE file.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agentic_mesh_protocol-1.0.1.dev1.tar.gz (75.6 kB view details)

Uploaded Jul 21, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

agentic_mesh_protocol-1.0.1.dev1-py3-none-any.whl (104.9 kB view details)

Uploaded Jul 21, 2026 Python 3

File details

Details for the file agentic_mesh_protocol-1.0.1.dev1.tar.gz.

File metadata

Download URL: agentic_mesh_protocol-1.0.1.dev1.tar.gz
Upload date: Jul 21, 2026
Size: 75.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for agentic_mesh_protocol-1.0.1.dev1.tar.gz
Algorithm	Hash digest
SHA256	`456618def1c5f389369cd2f44410315a04d37399a96cc11a1bb642a4cde5f2f0`
MD5	`98efffb56e419c48fcd6b8a0f16ba44f`
BLAKE2b-256	`36d004a97f2586910de6e1ed75c0e6fa6ffbc2517c247bb5a492651e316f4a6d`

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentic_mesh_protocol-1.0.1.dev1.tar.gz:

Publisher: publish.yml on DigitalKin-ai/service-apis-py

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: agentic_mesh_protocol-1.0.1.dev1.tar.gz
- Subject digest: 456618def1c5f389369cd2f44410315a04d37399a96cc11a1bb642a4cde5f2f0
- Sigstore transparency entry: 2211854857
- Sigstore integration time: Jul 21, 2026
Source repository:
- Permalink: DigitalKin-ai/service-apis-py@3bb7a2f809d99d3b48904e3522719f813ef01a65
- Branch / Tag: refs/tags/v1.0.1.dev1
- Owner: https://github.com/DigitalKin-ai
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@3bb7a2f809d99d3b48904e3522719f813ef01a65
- Trigger Event: release