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 module_dto_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_dto_pb2, module_service_pb2_grpc
# 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 = module_dto_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
- buf - Proto code generation (
brew install bufbuild/buf/buf); without it onPATH,task install:ampinstalls the submodule's npm copy instead
The whole Python package is generated into gen/ (gitignored) by task gen; nothing
importable is checked in.
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.
3 maintainers
Metadata
3 maintainers
Release files for agentic-mesh-protocol 1.0.3.dev0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| agentic_mesh_protocol-1.0.3.dev0.tar.gz | 94.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| agentic_mesh_protocol-1.0.3.dev0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 242.7 kB
Release files / agentic_mesh_protocol-1.0.3.dev0.tar.gz
| Download URL | agentic_mesh_protocol-1.0.3.dev0.tar.gz |
|---|---|
| Size | 94.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3682409aec76bc2aaf4a12d3ae2c9b61e198e0a5f06361aaabc66a5dd1aad6b1
|
|
BLAKE2b-256 checksum How to use checksums |
cc2f9a36c5a8e8e395884ea2fdebc1d96f02902bb04bbe09cc47eab650de6213
|
| 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 15, 2026.
Transparency logRelease files / agentic_mesh_protocol-1.0.3.dev0-py3-none-any.whl
| Download URL | agentic_mesh_protocol-1.0.3.dev0-py3-none-any.whl |
|---|---|
| Size | 148.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d2c004cbf576b14fe72735df051f81296d6993e5aeb5273881644cfcb160cdf6
|
|
BLAKE2b-256 checksum How to use checksums |
d7b0e21a4e303cd3dfff1f5ed696d8113d7deba227ef78b6e1a33c6b9477960b
|
| 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 15, 2026.
Transparency log
