1gRPC - An RPC library and framework 2=================================== 3 4gRPC is a modern, open source, high-performance remote procedure call (RPC) framework that can run anywhere. It enables client and server applications to communicate transparently, and makes it easier to build connected systems. 5 6<table> 7 <tr> 8 <td><b>Homepage:</b></td> 9 <td><a href="https://grpc.io/">grpc.io</a></td> 10 </tr> 11 <tr> 12 <td><b>Mailing List:</b></td> 13 <td><a href="https://groups.google.com/forum/#!forum/grpc-io">grpc-io@googlegroups.com</a></td> 14 </tr> 15</table> 16 17[](https://gitter.im/grpc/grpc?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) 18 19# To start using gRPC 20 21To maximize usability, gRPC supports the standard way of adding dependencies in your language of choice (if there is one). 22In most languages, the gRPC runtime comes in form of a package available in your language's package manager. 23 24For instructions on how to use the language-specific gRPC runtime in your project, please refer to these documents 25 26 * [C++](src/cpp): follow the instructions under the `src/cpp` directory 27 * [C#](src/csharp): NuGet package `Grpc` 28 * [Dart](https://github.com/grpc/grpc-dart): pub package `grpc` 29 * [Go](https://github.com/grpc/grpc-go): `go get google.golang.org/grpc` 30 * [Java](https://github.com/grpc/grpc-java): Use JARs from Maven Central Repository 31 * [Node](https://github.com/grpc/grpc-node): `npm install grpc` 32 * [Objective-C](src/objective-c): Add `gRPC-ProtoRPC` dependency to podspec 33 * [PHP](src/php): `pecl install grpc` 34 * [Python](src/python/grpcio): `pip install grpcio` 35 * [Ruby](src/ruby): `gem install grpc` 36 * [WebJS](https://github.com/grpc/grpc-web): follow the grpc-web instructions 37 38You can find per-language quickstart guides and tutorials in [Documentation section on grpc.io website](https://grpc.io/docs/). The code examples are available in the [examples](examples) directory. 39 40Precompiled bleeding-edge package builds of gRPC `master` branch's `HEAD` are uploaded daily to [packages.grpc.io](https://packages.grpc.io). 41 42# To start developing gRPC 43 44Contributions are welcome! 45 46Please read [How to contribute](CONTRIBUTING.md) which will guide you through the entire workflow of how to build the source code, how to run the tests and how to contribute your changes to 47the gRPC codebase. 48The document also contains info on how the contributing process works and contains best practices for creating contributions. 49 50# Troubleshooting 51 52Sometimes things go wrong. Please check out the [Troubleshooting guide](TROUBLESHOOTING.md) if you are experiencing issues with gRPC. 53 54# Performance 55 56See [Performance dashboard](http://performance-dot-grpc-testing.appspot.com/explore?dashboard=5636470266134528) for the performance numbers for the latest released version. 57 58# Concepts 59 60See [gRPC Concepts](CONCEPTS.md) 61 62# About This Repository 63 64This repository contains source code for gRPC libraries for multiple languages written on top of shared C core library [src/core](src/core). 65 66Libraries in different languages may be in different states of development. We are seeking contributions for all of these libraries. 67 68| Language | Source | 69|-------------------------|-------------------------------------| 70| Shared C [core library] | [src/core](src/core) | 71| C++ | [src/cpp](src/cpp) | 72| Ruby | [src/ruby](src/ruby) | 73| Python | [src/python](src/python) | 74| PHP | [src/php](src/php) | 75| C# | [src/csharp](src/csharp) | 76| Objective-C | [src/objective-c](src/objective-c) | 77 78| Language | Source repo | 79|-------------------------|------------------------------------------------------| 80| Java | [grpc-java](http://github.com/grpc/grpc-java) | 81| Go | [grpc-go](http://github.com/grpc/grpc-go) | 82| NodeJS | [grpc-node](https://github.com/grpc/grpc-node) | 83| WebJS | [grpc-web](https://github.com/grpc/grpc-web) | 84| Dart | [grpc-dart](https://github.com/grpc/grpc-dart) | 85 86
){kind=link}