adijeshen / primihub

Hyper Multi-Party computing platform

Primihub

Feature

Primihub is a platform that supports Multi-Party Computing(MPC), Federated Learning, Private set intersection (PSI), and Private Information Retrieval (PIR) features, and supports extensions of data source access, data consumption, access application, syntax, semantic and security protocols. For details, see Primihub Core Feature

Quick start

Run an Multi-Party Computing application in 5 minutes

Install docker and docker-compose

Download the code and switch to the code root path

$ git clone https://github.com/primihub/primihub.git
$ cd primihub

Run an MPC case

Start the test nodes

Start three docker containers using docker-compose. The container includes: one simple bootstrap node, three nodes

$ docker-compose up

Check out the running docker container

$ docker ps

  CONTAINER ID   IMAGE                                COMMAND                  CREATED          STATUS          PORTS                                                                         NAMES
cf875c1280be   primihub-node:1.0.5                  "/bin/bash -c './pri…"   11 minutes ago   Up 11 minutes   0.0.0.0:12120-12121->12120-12121/tcp, 0.0.0.0:8052->50050/tcp                 node2_primihub
6a822ff5c6f7   primihub-node:1.0.5                  "/bin/bash -c './pri…"   11 minutes ago   Up 11 minutes   0.0.0.0:10120->12120/tcp, 0.0.0.0:10121->12121/tcp, 0.0.0.0:8050->50050/tcp   node0_primihub
11d55ce06ff0   primihub-node:1.0.5                  "/bin/bash -c './pri…"   11 minutes ago   Up 11 minutes   0.0.0.0:11120->12120/tcp, 0.0.0.0:11121->12121/tcp, 0.0.0.0:8051->50050/tcp   node1_primihub
68befa6ab2a5   primihub/simple-bootstrap-node:1.0   "/app/simple-bootstr…"   11 minutes ago   Up 11 minutes   0.0.0.0:4001->4001/tcp                                                        simple_bootstrap_node

Create an MPC task

*** Let three nodes jointly perform a logistic regression task of multi-party secure computation (MPC) ***

$ docker run --network=host -it primihub/primihub-node:1.0.5 ./primihub-cli --server=127.0.0.1:8050

💡 The node response the task

You can request computing tasks from any node in the computing cluster

💡 Available task parameters

The following parameters can be specified through primihub-cli:

1. Which node is requested to start the task.
2. Which shared datasets are used.
3. What kind of private computing tasks to do.

In this example, primihub-cli will use the default parameters to request an ABY3 tripartite logistic regression test task from *** node 0 ***. For the parameters that can be specified by cli, please refer to *** Create task ***

Advanced use

To learn how to start from native applications and how to use Primihub features to implement more applications, see Advanced Usage

Developer

• For how to build, see Build
• For how to contribute code, see Primihub Open Source Community Governance