Skip to main content

The Python micro framework for building gPRC application.

Project description

gRPCAlchemy Documentation Status

The Python micro framework for building gPRC application based on official gRPC project.


$ pipenv install grpcalchemy

Only Python 3.6+ is supported.



from grpcalchemy.orm import Message, StringField
from grpcalchemy import Server, Context, grpcmethod

class HelloMessage(Message):
    text: str

class HelloService(Server):
    def Hello(self, request: HelloMessage, context: Context) -> HelloMessage:
        return HelloMessage(text=f'Hello {request.text}')

if __name__ == '__main__':

Then Using gRPC channel to connect the server:

from grpc import insecure_channel

from protos.helloservice_pb2_grpc import HelloServiceStub
from protos.hellomessage_pb2 import HelloMessage

with insecure_channel("localhost:50051") as channel:
    response = HelloServiceStub(channel).Hello(


  • gPRC Service Support
  • gRPC Message Support
    • Scalar Value Types
    • Message Types
    • Repeated Field
    • Maps
  • Define Message With Type Hint
  • Middleware
  • App Context Manger
  • Error Handler Support
  • Streaming Method Support
  • gRPC-Health Checking and Reflection Support (Alpha)
  • Multiple Processor Support


  • Test Client Support
  • Async Server Support



  • Improve initialize function of message
  • Remove default feature in message
  • Refactor composite message Type
  • Support gRPC with xDS
  • Add PROTO_AUTO_GENERATED setting to make runtime proto generation optional


  • fix [#36] compatibility in windows
  • fix [#34] compatibility in windows
  • gRPC-Health Checking and Reflection Support (Alpha)
  • Multiple Processor Support


  • Support Streaming Method
  • Deprecate request parameter in app context and handle exception


  • Support related directory path to generate protocol buffer files
  • Enable use type hint to define message
  • Add error handle to handle Exception
  • Add get_blueprints to get blueprints need to register


  • Support SSL
  • Improve Implement of Server with grpc.server
  • Support YAML file in Config Module
  • Improve Config Module
  • Add context in current rpc


  • Implement Rpc Context
  • Improve Config Module


  • Implement Globals Variable
  • Implement APP Context

0.2.2-3 (2019-02-26)

  • Improve Config module
  • Improve rpc_call_wrap

0.2.1 (2019-02-14)

  • Implement Own gRPC Server
  • Implement gRPC Server Test Client

0.2.0 (2019-01-30)

  • Change gRPCAlchemy Server register to register_blueprint
  • Make gRPCAlchemy Server inherit from Blueprint
  • Support Json Format
  • Support Inheritance Message

0.1.6 (2019-01-21)

  • Various bug-fixes
  • Improve tests
  • Change Client API
  • Add PreProcess And PostProcess
  • Import Config Object
  • Add Event Listener
  • Change Field Object Into Descriptor

0.1.5 (2018-12-14)

  • Various bug-fixes
  • Improve tests
  • Add client

0.1.4 (2018-12-11)

  • First release on PyPI.

Project details

Download files

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

Source Distribution

grpcalchemy-0.7.3.tar.gz (30.7 kB view hashes)

Uploaded source

Built Distribution

grpcalchemy-0.7.3-py2.py3-none-any.whl (19.5 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page