PrimiHub
中文 | English
特性
PrimiHub是一个支持多方计算、联邦学习、隐私求交(PSI)、隐私查询(PIR)特性的平台,支持数据源接入、数据消费、接入应用、语法、语义、安全协议多方面的扩展。 具体请见 PrimiHub 核心特性。
快速开始
5分钟运行起来一个MPC应用
运行一个MPC案例部署图
启动服务有两种方式,直接在物理机启动服务,基于docker容器获取服务
在物理机上启动服务
启动redis服务作为数据集meta信息的存储服务
获取应用的二进制有两种选择
1)直接从github获取发布的二进制文件最新发布
2) 下载预配置redis
x86_64
aarch64
3) 通过源码编译编译步骤
!!!注意: 发布的二进制文件是基于ubuntu20.04系统编译,在其他系统可能出现不兼容的情况
运行服务
执行 ./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 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
下载代码并进到代码根目录
cd primihub
启动测试用的节点
使用docker-compose 启动容器。
容器包括:启动点、redis、三个节点
或者,您也可以通过环境变量指定镜像服务地址以及版本号,例如:
查看运行起来的 docker 容器:
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)的逻辑回归任务
💡 请求任务的节点
你可以向计算集群中任意一个节点请求计算任务
💡 可用的任务参数
通过primihub-cli可以指定以下参数
- 请求哪个节点启动任务
- 使用哪些共享数据集
- 做什么样的隐私计算任务
在这个例子中primihub-cli会使用默认参数向 node 0 请求一个ABY3的三方逻辑回归测试任务,关于cli可以指定的参数请见 创建任务。
进阶使用
想了解如何从原生应用启动以及关于如何利用PrimiHub的特性,实现更多应用,见 进阶使用。
开发者
- 关于如何编译,请见编译
- 关于如何贡献代码,请见 PrimiHub开源社区治理
路线图
如何贡献
如果你想参与PrimiHub项目,可以在Issue 页面随意开启一个新的话题,比如文档、创意、Bug等。
同时可以了解我们的社区治理结构 PrimiHub社区治理委员会
我们是一个开放共建的开源项目,欢迎参与到我们的项目中。
贡献者
社区
- Slack: primihub.slack.com
- 微信助手: