Skip to main content

Perform numpy-like analysis on data that remains in someone elses server

Project description



Syft Logo

Perform data science on data that remains in someone else's server

Quickstart

LinuxmacOSWindowsDockerPodmanKubernetes

Install Client

$ pip install -U syft

Launch Server

# from Jupyter / Python
import syft as sy
sy.requires(">=0.8.1,<0.8.2")
node = sy.orchestra.launch(name="my-domain", port=8080, dev_mode=True, reset=True)
# or from the command line
$ syft launch --name=my-domain --port=8080 --reset=True

Starting syft-node server on 0.0.0.0:8080

Launch Client

import syft as sy
sy.requires(">=0.8.1,<0.8.2")
domain_client = sy.login(port=8080, email="info@openmined.org", password="changethis")

PySyft in 10 minutes

📝 API Example Notebooks

Deploy Kubernetes Helm Chart

Note: Assuming we have a Kubernetes cluster already setup.

1. Add and update Helm repo for Syft

$ helm repo add openmined https://openmined.github.io/PySyft/helm
$ helm repo update openmined

2. Search for available Syft versions

$ helm search repo openmined/syft --versions --devel

3. Set your preferred Syft Chart version

SYFT_VERSION="<paste the chart version number>"

4. Provisioning Helm Charts

$ helm install my-domain openmined/syft --version $SYFT_VERSION --namespace syft --create-namespace

Azure or GCP Ingress

$ helm install ... --set ingress.ingressClass="azure/application-gateway"
$ helm install ... --set ingress.ingressClass="gce"

Deploy to a Container Engine or Cloud

  1. Install our handy 🛵 cli tool which makes deploying a Domain or Gateway server to Docker or VM a one-liner:
    pip install -U hagrid

  2. Then run our interactive jupyter Install 🧙🏽‍♂️ WizardBETA:
    hagrid quickstart

  3. In the tutorial you will learn how to install and deploy:
    PySyft = our numpy-like 🐍 Python library for computing on private data in someone else's Domain

    PyGrid = our 🐳 docker / 🐧 vm Domain & Gateway Servers where private data lives

Docs and Support

Install Notes

  • HAGrid 0.3 Requires: 🐍 python 🐙 git - Run: pip install -U hagrid
  • Interactive Install 🧙🏽‍♂️ WizardBETA Requires 🛵 hagrid: - Run: hagrid quickstart
  • PySyft 0.8.1 Requires: 🐍 python 3.9 - 3.11 - Run: pip install -U syft
  • PyGrid Requires: 🐳 docker, 🦦 podman or ☸️ kubernetes - Run: hagrid launch ...

Versions

0.9.0 - Coming soon...
0.8.2 (Beta) - dev branch 👈🏽 API - Coming soon...
0.8.1 (Stable) - API

Deprecated:

PySyft and PyGrid use the same version and its best to match them up where possible. We release weekly betas which can be used in each context:

PySyft (Stable): pip install -U syft
PyGrid (Stable) hagrid launch ... tag=latest

PySyft (Beta): pip install -U syft --pre
PyGrid (Beta): hagrid launch ... tag=beta

HAGrid is a cli / deployment tool so the latest version of hagrid is usually the best.

What is Syft?

Syft

Syft is OpenMined's open source stack that provides secure and private Data Science in Python. Syft decouples private data from model training, using techniques like Federated Learning, Differential Privacy, and Encrypted Computation. This is done with a numpy-like interface and integration with Deep Learning frameworks, so that you as a Data Scientist can maintain your current workflow while using these new privacy-enhancing techniques.

Why should I use Syft?

Syft allows a Data Scientist to ask questions about a dataset and, within privacy limits set by the data owner, get answers to those questions, all without obtaining a copy of the data itself. We call this process Remote Data Science. It means in a wide variety of domains across society, the current risks of sharing information (copying data) with someone such as, privacy invasion, IP theft and blackmail will no longer prevent the vast benefits such as innovation, insights and scientific discovery which secure access will provide.

No more cold calls to get access to a dataset. No more weeks of wait times to get a result on your query. It also means 1000x more data in every domain. PySyft opens the doors to a streamlined Data Scientist workflow, all with the individual's privacy at its heart.

Terminology

👨🏻‍💼 Data Owners

👩🏽‍🔬 Data Scientists

Provide datasets which they would like to make available for study by an outside party they may or may not fully trust has good intentions.

Are end users who desire to perform computations or answer a specific question using one or more data owners' datasets.

🏰 Domain Server

🔗 Gateway Server

Manages the remote study of the data by a Data Scientist and allows the Data Owner to manage the data and control the privacy guarantees of the subjects under study. It also acts as a gatekeeper for the Data Scientist's access to the data to compute and experiment with the results.

Provides services to a group of Data Owners and Data Scientists, such as dataset search and bulk project approval (legal / technical) to participate in a project. A gateway server acts as a bridge between it's members (Domains) and their subscribers (Data Scientists) and can provide access to a collection of domains at once.

Community

Courses

Contributors

OpenMined and Syft appreciates all contributors, if you would like to fix a bug or suggest a new feature, please see our guidelines.

Contributors

Supporters

Open Collective

OpenMined is a fiscally sponsored 501(c)(3) in the USA. We are funded by our generous supporters on Open Collective.

Contributors

Disclaimer

Syft is under active development and is not yet ready for pilots on private data without our assistance. As early access participants, please contact us via Slack or email if you would like to ask a question or have a use case that you would like to discuss.

License

Apache License 2.0
Person icons created by Freepik - Flaticon

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

syft-0.8.2b39.tar.gz (338.7 kB view details)

Uploaded Source

Built Distribution

syft-0.8.2b39-py2.py3-none-any.whl (398.3 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file syft-0.8.2b39.tar.gz.

File metadata

  • Download URL: syft-0.8.2b39.tar.gz
  • Upload date:
  • Size: 338.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.5

File hashes

Hashes for syft-0.8.2b39.tar.gz
Algorithm Hash digest
SHA256 d3b4521843bba5dc0bf23c26936251ce4663dfd7af3cf67950142015eddbbf7f
MD5 b8063e0471d1ccb0aae8f1d552ab68e1
BLAKE2b-256 7eae5df41b9982f1ec685fd08019e0450b898454d69569d43ab4ee4b7c10113f

See more details on using hashes here.

File details

Details for the file syft-0.8.2b39-py2.py3-none-any.whl.

File metadata

  • Download URL: syft-0.8.2b39-py2.py3-none-any.whl
  • Upload date:
  • Size: 398.3 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.5

File hashes

Hashes for syft-0.8.2b39-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 cf56188816bf282a2148aa4629b0063e84b70a33b458ec26306ba0df052a90dd
MD5 8b9723685840555157ab89460e9a741f
BLAKE2b-256 b88c7dc928e51c5857ada1bf510c1f2dcc31bdaa36e5ffa428000e371f0293da

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page