gRPC Homebrew

This repo contains:

• gRPC homebrew formulae
• A utility script that simplifies installation of other gRPC packages

The formulae will be maintained here rather than adding them to the homebrew or linuxbrew repos until gRPC and protobuf 3.0 are generally available, i.e, gRPC reaches 1.0 and protobuf 3.0 is released.

Prerequisites

• On Mac OS X, install homebrew.
• On Linux, install linuxbrew.

Quick Install

The repo contains an install script that can be used to install gRPC and optionally install the gRPC package for Python, Node.Js and/or Ruby as long as homebrew/linuxbrew is available.

For convenience, the installer is also available at a short alias https://goo.gl/getgrpc

• To install the gRPC C core (this also installs the gRPC protoc plugins for C++, C#, ObjectiveC, Python and Ruby)

$ curl -fsSL https://goo.gl/getgrpc | bash -

• To install gRPC Python (it installs the gRPC C core if needed)
  • Prerequisite: python, pip and virtualenv. The installer uses pip to install the grpc python package.
    • (Ubuntu/Debian) Install python-dev

    $ sudo apt-get install python-dev

    • Install pip

    $ sudo easy_install pip

    • Activate a virtualenv before running the installer

    $ sudo pip install virtualenv
    $ virtualenv venv
    $ source venv/bin/activate

$ curl -fsSL https://goo.gl/getgrpc | bash -s python

• To install gRPC Node.js (it installs the gRPC C core if needed)
  • Tip: Node needs to be available; you can install it quickly using nvm

$ curl -fsSL https://goo.gl/getgrpc | bash -s nodejs

• To install gRPC Ruby (it installs the gRPC C core if needed)
  • Tip: Ruby needs to be available; you can install it quickly using rvm

$ curl -fsSL https://goo.gl/getgrpc | bash -s ruby

• To install gRPC PHP extension (it installs the gRPC C core if needed)
  • Prerequisite: PHP 5.5 or higher, php5-dev

$ curl -fsSL https://goo.gl/getgrpc | bash -s php

Using the formulae directly

Just brew tap grpc/grpc and then brew install <formula>.

If the formula here conflicts with one from Homebrew/homebrew or another tap, you can do brew install grpc/grpc/<formula>.

You can also install via URL:

brew install https://raw.githubusercontent.com/grpc/homebrew-grpc/master/<formula>.rb

Docs

brew help, man brew, or the Homebrew wiki.