PrimiHub

中文 | English

特性

PrimiHub是一个支持多方计算、联邦学习、隐私求交(PSI)、隐私查询(PIR)特性的平台，支持数据源接入、数据消费、接入应用、语法、语义、安全协议多方面的扩展。 具体请见 PrimiHub 核心特性。

GitHub源码

快速开始

5分钟运行起来一个MPC应用

运行一个MPC案例部署图

启动服务有两种方式，直接在物理机启动服务，基于docker容器获取服务

在物理机上启动服务

启动redis服务作为数据集meta信息的存储服务

获取应用的二进制有两种选择
1）直接从github获取发布的二进制文件最新发布
2) 下载预配置redis
x86_64
aarch64
3) 通过源码编译编译步骤

！！！注意： 发布的二进制文件是基于ubuntu20.04系统编译，在其他系统可能出现不兼容的情况

运行服务

进入 redis 目录
执行 ./run_redis.sh 启动redis
切换到与bazel-bin平行的目录
注意！！！！！！ 如果目标程序是通过源码编译获取的，请手动将start_server.sh中定义的PYTHONPATH环境变量注释
./start_server.sh

服务的日志分别存储在log_node0, log_node1, log_node2文件中，便于以后查看
如果服务正常运行，通过linux命令 ps -ef |grep bin/node, 你会获取到一下服务信息

root       4915       1  0 3月13 ?        00:08:49 ./redis-server 127.0.0.1:6379
root    4172627       1  0 10:03 pts/6    00:00:00 ./bazel-bin/node --node_id=node0 --service_port=50050 --config=./config/node0.yaml
root    4172628       1  0 10:03 pts/6    00:00:00 ./bazel-bin/node --node_id=node1 --service_port=50051 --config=./config/node1.yaml
root    4172629       1  0 10:03 pts/6    00:00:00 ./bazel-bin/node --node_id=node2 --service_port=50052 --config=./config/node2.yaml

基于docker容器 启动服务

安装 docker 和 docker-compose
下载代码并进到代码根目录

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

启动测试用的节点

使用docker-compose 启动容器。
容器包括：启动点、redis、三个节点

docker-compose up -d

或者，您也可以通过环境变量指定镜像服务地址以及版本号，例如：

echo -e "REGISTRY=registry.cn-beijing.aliyuncs.com\nTAG=1.5.0" >> .env && docker-compose up -d

查看运行起来的 docker 容器：

docker-compose ps

NAME                    COMMAND                  SERVICE                 STATUS              PORTS
primihub-node0          "/bin/bash -c './pri…"   node0                   running             0.0.0.0:6666->6666/tcp, 0.0.0.0:8050->50050/tcp
primihub-node1          "/bin/bash -c './pri…"   node1                   running             0.0.0.0:6667->6667/tcp, 0.0.0.0:8051->50051/tcp
primihub-node2          "/bin/bash -c './pri…"   node2                   running             0.0.0.0:6668->6668/tcp, 0.0.0.0:8052->50052/tcp
redis                   "docker-entrypoint.s…"   redis                   running             0.0.0.0:6379->6379/tcp
simple_bootstrap_node   "/app/simple-bootstr…"   simple_bootstrap_node   running             0.0.0.0:4001->4001/tcp

创建一个MPC任务

让三个节点共同执行一个多方安全计算（MPC）的逻辑回归任务

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

💡 请求任务的节点

你可以向计算集群中任意一个节点请求计算任务

💡 可用的任务参数

通过primihub-cli可以指定以下参数

1. 请求哪个节点启动任务
2. 使用哪些共享数据集
3. 做什么样的隐私计算任务

在这个例子中primihub-cli会使用默认参数向 node 0 请求一个ABY3的三方逻辑回归测试任务，关于cli可以指定的参数请见 创建任务。

进阶使用

想了解如何从原生应用启动以及关于如何利用PrimiHub的特性，实现更多应用，见 进阶使用。

开发者

• 关于如何编译，请见编译
• 关于如何贡献代码，请见 PrimiHub开源社区治理

路线图

如何贡献

如果你想参与PrimiHub项目，可以在Issue 页面随意开启一个新的话题，比如文档、创意、Bug等。
同时可以了解我们的社区治理结构 PrimiHub社区治理委员会
我们是一个开放共建的开源项目，欢迎参与到我们的项目中。

贡献者

contrib.rocks

社区

• Slack: primihub.slack.com
• 微信助手: