Skip to main content

Substra CLI for interacting with substra-backend

Project description



Substra


Substra is an open source federated learning (FL) software. It enables the training and validation of machine learning models on distributed datasets. It provides a flexible Python interface and a web application to run federated learning training at scale. This specific repository is the low-level Python library used to interact with a Substra network.

Substra's main usage is in production environments. It has already been deployed and used by hospitals and biotech companies (see the MELLODDY project for instance). Substra can also be used on a single machine to perform FL simulations and debug code.

Substra was originally developed by Owkin and is now hosted by the Linux Foundation for AI and Data. Today Owkin is the main contributor to Substra.

Join the discussion on Slack and subscribe here to our newsletter.

To start using Substra

Have a look at our documentation.

Try out our MNIST example.

Support

If you need support, please either raise an issue on Github or ask on Slack.

Contributing

Substra warmly welcomes any contribution. Feel free to fork the repo and create a pull request.

Setup

To setup the project in development mode, run:

pip install -e ".[dev]"

To run all tests, use the following command:

python setup.py test

Code formatting

You can opt into auto-formatting of code on pre-commit using Black.

This relies on hooks managed by pre-commit, which you can set up as follows.

Install pre-commit, then run:

pre-commit install

Documentation generation

To generate the command line interface documentation, sdk and schemas documentation, the python version must be 3.8. Run the following command:

make doc

Documentation will be available in the references/ directory.

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

substra-0.41.0rc1.tar.gz (73.5 kB view details)

Uploaded Source

Built Distribution

substra-0.41.0rc1-py3-none-any.whl (62.3 kB view details)

Uploaded Python 3

File details

Details for the file substra-0.41.0rc1.tar.gz.

File metadata

  • Download URL: substra-0.41.0rc1.tar.gz
  • Upload date:
  • Size: 73.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.16

File hashes

Hashes for substra-0.41.0rc1.tar.gz
Algorithm Hash digest
SHA256 d6554a7e1ab8bc7e953e08b1783b16defe282a4d12eb8bab6d02f2d8b08fbfbc
MD5 7afcdbb09e89b0d98d7d82f5888b48e7
BLAKE2b-256 85cc4a66f4a4b84b8ed64db4301cf9d002b636f90d919ef7f554714d01dd309b

See more details on using hashes here.

File details

Details for the file substra-0.41.0rc1-py3-none-any.whl.

File metadata

  • Download URL: substra-0.41.0rc1-py3-none-any.whl
  • Upload date:
  • Size: 62.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.16

File hashes

Hashes for substra-0.41.0rc1-py3-none-any.whl
Algorithm Hash digest
SHA256 055eeed723668673f89060c5a4e1f279d1ab347b55ae8efcbc4fe1c3364508f3
MD5 d8ab6e27d889b3eea8f3d249890eef25
BLAKE2b-256 d96527eb8810edb8399e60f66337b0067c3e3d2b9b82dcbbff0bce4f68d87144

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