English | 中文

tRPC - A multi-language, pluggable, high-performance RPC framework

What is tRPC

tRPC is a high-performance RPC framework that designed based on the concept of pluggable，the overall design follows the following principles:

• Simple: Users develop service very simply based on the framework.
• High-Performance: The performant of the framework can be applicable to massive scenario on the internet.
• Pluggable: The framework is layered and modularized in architectural design and implementation, and each core module be pluggable and evolves independently.

By using tRPC, you can:

• Build services (tRPC/HTTP(s)/gRPC, etc.) with multiple ports that support multiple protocols (one port only support one protocol), and can handle client requests synchronously/asynchronously.
• Access various protocol backend services (tRPC/HTTP(s)/gRPC, etc.) in a synchronous, asynchronous, and one-way.
• Streaming RPC programming, currently supports tRPC streaming, gRPC streaming, HTTP streaming, etc., to implement streaming application services such as Push, File Upload/Download, and AI Serving.
• Support various protocols and service governance systems, such as: customized protocols, various name-service/metrics systems/tracing systems/config-center systems/log system, etc., to facilitate service interoperability and operation.

Features

• Works across languages：Implements cross-language service communication based on Protocol Buffers.
• Support multi-protocols：Supports multiple protocols and interoperates with different frameworks (such as gRPC).
• Streaming RPC: Supports streaming RPC, which is better suited for various application scenarios such as large file upload/download, message push, AI speech recognition/video understanding, etc.
• Rich plugin ecosystem: Provides a large number of plugins that docking to microservice components (such as Consul/Promethues/OpenTelemetry, etc.) to facilitate users to build their own service governance system.
• Scalability: Based on the pluggable design of the framework, users can develop secondary to expand the framework capabilities, such as: parameter validation, authentication, log replay, etc.
• Flow & Overload control: provides flow control and overload protection plugins in a variety of application scenarios to prevent services from being overloaded and unavailable due to burst traffic.

Supported languages

• Cpp
• Go

To start using tRPC

Per-language quickstart guides and tutorials can be found in the tRPC website . Code examples are available in the examples directory.

• tRPC
  • architecture design
  • terminology
  • plugin ecosystem
  • trpc protocol
• tRPC-Cpp:
  • quick start
  • basic tutorial
  • user guide
  • examples
• tRPC-Go:
  • quick start
  • basic tutorial
  • user guide
  • examples

To start developing tRPC

Contributions are welcome!

Please read How to contribute which will guide you through the entire workflow of how to build the source code, how to run the tests, and how to contribute changes to the tRPC codebase.

Feedback

Report bugs, ask questions or give suggestions by Issues

Copyright

The copyright notice pertaining to the Tencent code in this repo was previously in the name of “THL A29 Limited.” That entity has now been de-registered. You should treat all previously distributed copies of the code as if the copyright notice was in the name of “Tencent.”