Skip to main content
Pre-release

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

agentic-mesh-protocol

CI PyPI Python Version License

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

  1. Update code and commit changes
  2. Use the GitHub "Create Release" workflow to bump version (patch, minor, major)
  3. 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.dev4.tar.gz (75.0 kB view details)

Uploaded Source

Built Distribution

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

agentic_mesh_protocol-1.0.1.dev4-py3-none-any.whl (104.8 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for agentic_mesh_protocol-1.0.1.dev4.tar.gz
Algorithm Hash digest
SHA256 5e05a8a71121f9ffb9122636a0cd6fd65b195aa6b76e1cbd397829cd6a4e0552
MD5 da72bd900ed355b5bbde32394a180cbb
BLAKE2b-256 64708b857e3af62dad30b09e31cbe41a45e571c691a64fbd16368e336b59df75

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentic_mesh_protocol-1.0.1.dev4.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.

File details

Details for the file agentic_mesh_protocol-1.0.1.dev4-py3-none-any.whl.

File metadata

File hashes

Hashes for agentic_mesh_protocol-1.0.1.dev4-py3-none-any.whl
Algorithm Hash digest
SHA256 9028570290ad7311f8610619ac9e7f4bd9ce1e5d14117430748ad470ff8e8284
MD5 23524d900558b8009672265de6e356f2
BLAKE2b-256 100f3da3dbcd044e01ad7eb6719c6df4f1f812366cf0f482e739dff75ecef49b

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentic_mesh_protocol-1.0.1.dev4-py3-none-any.whl:

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.
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page