Syft + Grid provides secure and private Deep Learning in Python
Syft decouples private data from model training, using Federated Learning, Differential Privacy, and Encrypted Computation (like Multi-Party Computation (MPC) and Homomorphic Encryption (HE)) within the main Deep Learning frameworks like PyTorch and TensorFlow. Join the movement on Slack.
Most software libraries let you compute over the information you own and see inside of machines you control. However, this means that you cannot compute on information without first obtaining (at least partial) ownership of that information. It also means that you cannot compute using machines without first obtaining control over those machines. This is very limiting to human collaboration and systematically drives the centralization of data, because you cannot work with a bunch of data without first putting it all in one (central) place.
The Syft ecosystem seeks to change this system, allowing you to write software which can compute over information you do not own on machines you do not have (total) control over. This not only includes servers in the cloud, but also personal desktops, laptops, mobile phones, websites, and edge devices. Wherever your data wants to live in your ownership, the Syft ecosystem exists to help keep it there while allowing it to be used privately for computation.
Stable Release
The current stable release is 0.5.0
which is available on:
For many use cases you can simply use:
$ pip install syft
If you are doing the Private AI Series or you are an external party developing against Syft and Grid please use the syft_0.5.0
branch.
Development Branch
This is the dev
branch and to accommodate our need to experiment with new ideas and implementations we will be moving a few things around during the early stages of 0.6.0
. Currently the core syft
library and code will remain fairly stable, while we do some much needed quality improvements and refactors to the grid
codebase and its tooling for deployment and orchestration of nodes. During the process of development we will be moving examples from the /packages/syft/examples
folder down to the /notebooks
folder and ensuring they are working and tested with the latest dev
code.
Mono Repo ?
This repo contains multiple sub-projects which work together.
OpenMined/PySyft
├── README.md <-- You are here ?
└── packages
├── grid <-- Grid - A network aware, persistent & containerized node running Syft
├── notebooks <-- Notebook Examples and Tutorials
└── syft <-- Syft - A package for doing remote data science on private data
Syft
To read more about what Syft is please consult the current 0.5.0
README.
Grid
To read more about what Grid is please consult the old PyGrid README until we finish writing the new one.
Dev Requirements
- docker
- tox
- python 3.7+
Docker
You will need docker
and docker-compose
to do development on the monorepo
tooling.
Dev Compose File
Run the FastAPI Dev environment using:
$ cd packages/grid
$ source .env && docker compose up
Rebuilding Docker Containers
$ cd packages/grid
$ docker compose build
Tox
You will need tox
to run some of our build and test tools.
$ pip install tox
List Build Commands
$ tox -l
You should see the following:
syft.jupyter
syft.lint
syft.test.fast
syft.test.libs
syft.test.duet
syft.test.security
These commands can be run like so:
$ tox -e syft.lint
Single VM Deployment
We are providing a simple way to deploy all of our stack inside a single VM so that no
matter where you want to run everything you can do so easily by thinking in terms of a
single machine either bare metal or VM and have it provisioned and auto updated.
To develop against this locally you will want the following:
- vagrant
- virtualbox
- ansible
- hagrid <-- in packages/hagrid
HAGrid Install
You can install HAGrid with pip:
$ pip install "git+https://github.com/OpenMined/PySyft@demo_strike_team_branch_4#subdirectory=packages/hagrid"
MacOS Instructions
$ brew install vagrant virtualbox ansible
Hagrid the Grid deployment tool:
$ cd packages/hagrid
$ pip install -e .
Vagrant
Vagrant allows us to create and manage VMs locally for development. During the startup
process of creating the VM the ansible provisioning scripts will be applied automatically
to the VM. If you change the Vagrantfile which describes how the VM is defined you will
need to either vagrant reload
or destroy and re-create it.
Making changes to the VM state should be done through the ansible
scripts so that
the state of the box is idempotent and re-running the ansible provisioning scripts
should always result in the same working grid node state.
To allow rapid development we mount the PySyft source repo into the VM at the path:/home/om/PySyft
which is where it would be if it was cloned down on a real remote VM.
The configuration is done via a Vagrantfile
which is written in ruby.
Vagrant Networking
Vagrant IP
The VM will be accessible on the IP 10.0.1.2
which is defined in the Vagrantfile
.
Vagrant Landrush Plugin
The Landrush plugin for vagrant gives us an automatic dns service so we can access our
local VM as though it were a real live domain on the internet.
$ vagrant plugin install landrush
With this enabled you can access the box on:http://node.openmined.grid
Starting VM
NOTE: You may need your sudo password to enable the landrush DNS entry on startup.
$ cd packages/grid
$ vagrant up --provision
Provisioning the VM
You want to do this any time you are testing out your ansible
changes.
$ cd packages/grid
$ vagrant provision
If you want to do a quick deploy where you skip the system provisioning you can run:
$ ANSIBLE_ARGS='--extra-vars "deploy_only=true"' vagrant provision
Connecting to Vagrant VM
$ cd packages/grid
$ vagrant ssh
Deploy to Cloud
Azure 1-click Quickstart Template
HAGrid Deployment
Create a VM on your cloud provider with Ubuntu 20.04 with at least:
- 2x CPU
- 4gb RAM
- 40gb HDD
Generate or supply a private key and note down the username.
Run the following:
$ hagrid launch node --type=domain --host=104.42.26.195 --username=ubuntu --key_path=~/.ssh/key.pem
Deploy vs Provision
If you want to later skip the setup process of installing packages and docker engine etc you can pass in --mode=deploy which will skip those steps.
Use a Custom PySyft Fork
If you wish to use a different fork of PySyft you can pass in --repo=The-PET-Lab-at-the-UN-PPTTT/PySyft --branch=ungp_pet_lab
Switching to the OpenMined user
$ sudo su - om
Cloud Images
We are using Packer to build cloud images in a very similar fashion to the dev Vagrant box.
To build images you will need the following:
- packer
- vagrant
- virtualbox
- ansible
MacOS Instructions
$ brew install packer vagrant virtualbox ansible
Build a Local Vagrant Box
Go to the following directory:
cd packages/grid/packer
Run:
./build_vagrant.sh
What this does is first build the base image, by downloading a Ubuntu .iso and automating
an install to a virtual machine. After the base image is created, the same ansible
provisioning scripts that we use in HAGrid and the Vagrant Dev environment above are
run against the image and finally a few shell scripts are executed to update some
Ubuntu packages and clean out a lot of unused stuff to squeeze the image size down.
To verify it worked you can start the Vagrant file like this:
cd packages/grid/packer
vagrant up
This system will start and automatically have the stack running and available on the local
ip http://10.0.1.3/ you can also SSH into this box using the credentials in the Vagrantfile.
Azure Cloud Image
To create the azure cloud image you need to have the az
cli tool and make sure you are authenticated.
Install the CLI tool:
$ pip install az
Authenticate your CLI tool:
$ az login
You will need to use a resource group and create a storage account within that resource group.
Create a resource group called: openmined-images
$ az group create -n openmined-images -l westus
Create an app to use within the packer file:
$ az ad sp create-for-rbac --name openmined-images > azure_vars.json
This will create a file called azure_vars.json
which will look something like this:
{
"appId": "21b92977-8ad0-467c-ae3a-47c864418126",
"displayName": "openmined-images",
"name": "21b92977-8ad0-467c-ae3a-47c864418126",
"password": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"tenant": "e3f9defa-1378-49b3-aed7-3dcacb468c41"
}
You need to know your subscription_id
:
$ SUBSCRIPTION_ID=$(az account show --query id | tr -d '"')
You can now build the image:
$ ./build_azure.sh ${SUBSCRIPTION_ID}
Create a Shared Image Gallery
Create a Shared image gallery within Azure.
Join Slack
Also, join the rapidly growing community of 12,000+ on Slack.
The Slack community is very friendly and great about quickly answering questions about the use and development of PySyft!
Disclaimer
This software is in beta. Use at your own risk.