Metadata-Version: 2.1
Name: bitfount
Version: 0.6.15
Summary: Machine Learning and Federated Learning Library.
Home-page: https://github.com/bitfount/bitfount
Author: Bitfount
Author-email: info@bitfount.com
License: Apache License 2.0
Project-URL: Documentation, https://docs.bitfount.com/
Project-URL: Homepage, https://bitfount.com
Project-URL: Source Code, https://github.com/bitfount/bitfount/
Project-URL: Hub, https://hub.bitfount.com
Keywords: federated learning,privacy,AI,machine learning
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Intended Audience :: Healthcare Industry
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
Classifier: Topic :: Scientific/Engineering :: Image Processing
Classifier: Topic :: Security :: Cryptography
Classifier: Topic :: System :: Distributed Computing
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8,<3.11,!=3.9.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: GPUtil >=1.4.0
Requires-Dist: Pillow <9.4.0,>=8.3.2
Requires-Dist: PyYAML ==6.0.1
Requires-Dist: aiohttp >=3.8.0
Requires-Dist: albumentations >=1.0.0
Requires-Dist: async-timeout ~=4.0
Requires-Dist: attrs >=19.3.0
Requires-Dist: bitfount-apispec >=6.3.0
Requires-Dist: bleach >=3.3.0
Requires-Dist: cryptography >=3.4.4
Requires-Dist: decorator >=5.0.0
Requires-Dist: desert >=2022.9.22
Requires-Dist: docstring-parser >=0.14.1
Requires-Dist: environs >=9.0
Requires-Dist: envyaml >=1.10.211231
Requires-Dist: filetype >=1.2.0
Requires-Dist: fire >=0.1.0
Requires-Dist: gmpy2 >=2.1.0
Requires-Dist: grpcio >=1.48.0
Requires-Dist: httpx >=0.23.0
Requires-Dist: ipython >=8.8.0
Requires-Dist: isort >=5.0.1
Requires-Dist: lightgbm <4.0.0,>=3.0.0
Requires-Dist: lxml >=4.6.5
Requires-Dist: marshmallow-enum >=1.5.1
Requires-Dist: marshmallow-polyfield >=5.10
Requires-Dist: marshmallow-union >=0.1.15
Requires-Dist: marshmallow >=3.13.0
Requires-Dist: methodtools >=0.4.5
Requires-Dist: msgpack >=1.0.0
Requires-Dist: numpy >=1.22
Requires-Dist: opencv-python-headless >=4.7.0.72
Requires-Dist: packaging >=22.0
Requires-Dist: pandas <2,>=1.3.0
Requires-Dist: pandasql >=0.7.3
Requires-Dist: protobuf <5,>=4
Requires-Dist: psutil >=5.0.0
Requires-Dist: pyarrow ~=7.0.0
Requires-Dist: pydantic >=1.0
Requires-Dist: pyjwt >=2.4.0
Requires-Dist: pytest >=7.2.0
Requires-Dist: pytorch-lightning <2,>=1.6.0
Requires-Dist: pytorch-tabnet >=3.0.0
Requires-Dist: requests >=2.26.0
Requires-Dist: scikit-image >=0.18.0
Requires-Dist: scikit-learn >=1.0
Requires-Dist: selenium <4.3
Requires-Dist: sqlalchemy <2,>=1.4.0
Requires-Dist: sqlparse >=0.4.2
Requires-Dist: sqlvalidator >=0.0.18
Requires-Dist: statsmodels >=0.11.0
Requires-Dist: tensorboard >=2.2.0
Requires-Dist: timm >=0.9.7
Requires-Dist: torch-optimizer >=0.1.0
Requires-Dist: torch <2,>=1.8.1
Requires-Dist: torchio >=0.18.91
Requires-Dist: torchmetrics <=0.10.2,>=0.6.0
Requires-Dist: torchvision <0.15,>=0.9.1
Requires-Dist: transformers >=4.23.0
Requires-Dist: types-decorator >=5.1.4
Requires-Dist: typing-extensions >=4.0.0
Requires-Dist: urllib3 <2,>=1.26.5
Requires-Dist: ipython <8.13 ; python_version < "3.9"
Provides-Extra: dicom
Requires-Dist: pydicom ~=2.3.1 ; extra == 'dicom'
Requires-Dist: python-gdcm ~=3.0.22 ; extra == 'dicom'
Provides-Extra: dp
Requires-Dist: opacus <1.2,>=1 ; extra == 'dp'
Requires-Dist: pytorch-lightning !=1.6.4,!=1.6.5,<1.7,<2,>=1.6.0 ; extra == 'dp'
Requires-Dist: smartnoise-sql <1,>=0.2.3 ; extra == 'dp'
Requires-Dist: torch <2,==1.8.1,>=1.8.1 ; extra == 'dp'
Requires-Dist: torchcsprng >=0.2.1 ; extra == 'dp'
Requires-Dist: torchvision <0.15,==0.9.1,>=0.9.1 ; extra == 'dp'
Provides-Extra: tests
Requires-Dist: aiohttp ==3.8.4 ; extra == 'tests'
Requires-Dist: aiosignal ==1.3.1 ; extra == 'tests'
Requires-Dist: alembic ==1.11.1 ; extra == 'tests'
Requires-Dist: anyio ==3.7.0 ; extra == 'tests'
Requires-Dist: appdirs ==1.4.4 ; extra == 'tests'
Requires-Dist: appnope ==0.1.3 ; extra == 'tests'
Requires-Dist: argon2-cffi ==21.3.0 ; extra == 'tests'
Requires-Dist: argon2-cffi-bindings ==21.2.0 ; extra == 'tests'
Requires-Dist: arrow ==1.2.3 ; extra == 'tests'
Requires-Dist: asttokens ==2.2.1 ; extra == 'tests'
Requires-Dist: async-generator ==1.10 ; extra == 'tests'
Requires-Dist: async-timeout ==4.0.2 ; extra == 'tests'
Requires-Dist: attrs ==23.1.0 ; extra == 'tests'
Requires-Dist: backcall ==0.2.0 ; extra == 'tests'
Requires-Dist: backports-zoneinfo ==0.2.1 ; extra == 'tests'
Requires-Dist: beautifulsoup4 ==4.12.2 ; extra == 'tests'
Requires-Dist: bleach ==6.0.0 ; extra == 'tests'
Requires-Dist: blinker ==1.6.2 ; extra == 'tests'
Requires-Dist: boto3 ==1.26.153 ; extra == 'tests'
Requires-Dist: botocore ==1.29.153 ; extra == 'tests'
Requires-Dist: bravado ==11.0.3 ; extra == 'tests'
Requires-Dist: bravado-core ==5.17.1 ; extra == 'tests'
Requires-Dist: cachetools ==5.3.1 ; extra == 'tests'
Requires-Dist: certifi ==2023.5.7 ; extra == 'tests'
Requires-Dist: cffi ==1.15.1 ; extra == 'tests'
Requires-Dist: chardet ==5.1.0 ; extra == 'tests'
Requires-Dist: charset-normalizer ==3.1.0 ; extra == 'tests'
Requires-Dist: chromedriver-autoinstaller ==0.4.0 ; extra == 'tests'
Requires-Dist: click ==8.1.3 ; extra == 'tests'
Requires-Dist: cloudpickle ==2.2.1 ; extra == 'tests'
Requires-Dist: colorama ==0.4.6 ; extra == 'tests'
Requires-Dist: comm ==0.1.3 ; extra == 'tests'
Requires-Dist: contourpy ==1.1.0 ; extra == 'tests'
Requires-Dist: coverage[toml] ==7.2.7 ; extra == 'tests'
Requires-Dist: cryptography ==41.0.1 ; extra == 'tests'
Requires-Dist: cycler ==0.11.0 ; extra == 'tests'
Requires-Dist: databricks-cli ==0.17.7 ; extra == 'tests'
Requires-Dist: debugpy ==1.6.7 ; extra == 'tests'
Requires-Dist: decorator ==5.1.1 ; extra == 'tests'
Requires-Dist: defusedxml ==0.7.1 ; extra == 'tests'
Requires-Dist: distlib ==0.3.6 ; extra == 'tests'
Requires-Dist: docker ==6.1.3 ; extra == 'tests'
Requires-Dist: docker-pycreds ==0.4.0 ; extra == 'tests'
Requires-Dist: entrypoints ==0.4 ; extra == 'tests'
Requires-Dist: et-xmlfile ==1.1.0 ; extra == 'tests'
Requires-Dist: exceptiongroup ==1.1.1 ; extra == 'tests'
Requires-Dist: execnet ==1.9.0 ; extra == 'tests'
Requires-Dist: executing ==1.2.0 ; extra == 'tests'
Requires-Dist: fastjsonschema ==2.17.1 ; extra == 'tests'
Requires-Dist: filelock ==3.12.2 ; extra == 'tests'
Requires-Dist: flask ==2.3.2 ; extra == 'tests'
Requires-Dist: fonttools ==4.40.0 ; extra == 'tests'
Requires-Dist: fqdn ==1.5.1 ; extra == 'tests'
Requires-Dist: frozenlist ==1.3.3 ; extra == 'tests'
Requires-Dist: future ==0.18.3 ; extra == 'tests'
Requires-Dist: gitdb ==4.0.10 ; extra == 'tests'
Requires-Dist: gitpython ==3.1.31 ; extra == 'tests'
Requires-Dist: gunicorn ==20.1.0 ; extra == 'tests'
Requires-Dist: h11 ==0.14.0 ; extra == 'tests'
Requires-Dist: httpcore ==0.17.2 ; extra == 'tests'
Requires-Dist: httpx ==0.24.1 ; extra == 'tests'
Requires-Dist: idna ==3.4 ; extra == 'tests'
Requires-Dist: importlib-metadata ==6.6.0 ; extra == 'tests'
Requires-Dist: importlib-resources ==5.12.0 ; extra == 'tests'
Requires-Dist: iniconfig ==2.0.0 ; extra == 'tests'
Requires-Dist: ipykernel ==6.23.2 ; extra == 'tests'
Requires-Dist: ipynb ==0.5.1 ; extra == 'tests'
Requires-Dist: ipython-genutils ==0.2.0 ; extra == 'tests'
Requires-Dist: isoduration ==20.11.0 ; extra == 'tests'
Requires-Dist: itsdangerous ==2.1.2 ; extra == 'tests'
Requires-Dist: jedi ==0.18.2 ; extra == 'tests'
Requires-Dist: jinja2 ==3.1.2 ; extra == 'tests'
Requires-Dist: jmespath ==1.0.1 ; extra == 'tests'
Requires-Dist: joblib ==1.2.0 ; extra == 'tests'
Requires-Dist: jsonpointer ==2.3 ; extra == 'tests'
Requires-Dist: jsonref ==1.1.0 ; extra == 'tests'
Requires-Dist: jsonschema[format,format-nongpl] ==4.17.3 ; extra == 'tests'
Requires-Dist: jupyter-client ==8.2.0 ; extra == 'tests'
Requires-Dist: jupyter-core ==5.3.1 ; extra == 'tests'
Requires-Dist: jupyter-events ==0.6.3 ; extra == 'tests'
Requires-Dist: jupyter-server ==2.6.0 ; extra == 'tests'
Requires-Dist: jupyter-server-terminals ==0.4.4 ; extra == 'tests'
Requires-Dist: jupyterlab-pygments ==0.2.2 ; extra == 'tests'
Requires-Dist: jupytext ==1.14.6 ; extra == 'tests'
Requires-Dist: kiwisolver ==1.4.4 ; extra == 'tests'
Requires-Dist: mako ==1.2.4 ; extra == 'tests'
Requires-Dist: markdown ==3.4.3 ; extra == 'tests'
Requires-Dist: markdown-it-py ==2.2.0 ; extra == 'tests'
Requires-Dist: markupsafe ==2.1.3 ; extra == 'tests'
Requires-Dist: matplotlib ==3.7.1 ; extra == 'tests'
Requires-Dist: matplotlib-inline ==0.1.6 ; extra == 'tests'
Requires-Dist: mdit-py-plugins ==0.4.0 ; extra == 'tests'
Requires-Dist: mdurl ==0.1.2 ; extra == 'tests'
Requires-Dist: mirakuru ==2.5.1 ; extra == 'tests'
Requires-Dist: mistune ==2.0.5 ; extra == 'tests'
Requires-Dist: mlflow ==2.4.1 ; extra == 'tests'
Requires-Dist: monotonic ==1.6 ; extra == 'tests'
Requires-Dist: msgpack ==1.0.5 ; extra == 'tests'
Requires-Dist: multidict ==6.0.4 ; extra == 'tests'
Requires-Dist: nbclassic ==1.0.0 ; extra == 'tests'
Requires-Dist: nbclient ==0.8.0 ; extra == 'tests'
Requires-Dist: nbconvert ==7.5.0 ; extra == 'tests'
Requires-Dist: nbformat ==5.9.0 ; extra == 'tests'
Requires-Dist: neptune-client ==1.2.0 ; extra == 'tests'
Requires-Dist: nest-asyncio ==1.5.6 ; extra == 'tests'
Requires-Dist: notebook ==6.5.4 ; extra == 'tests'
Requires-Dist: notebook-shim ==0.2.3 ; extra == 'tests'
Requires-Dist: numpy ==1.24.3 ; extra == 'tests'
Requires-Dist: oauthlib ==3.2.2 ; extra == 'tests'
Requires-Dist: openpyxl ==3.1.2 ; extra == 'tests'
Requires-Dist: outcome ==1.2.0 ; extra == 'tests'
Requires-Dist: overrides ==7.3.1 ; extra == 'tests'
Requires-Dist: packaging ==23.1 ; extra == 'tests'
Requires-Dist: pandas ==1.5.3 ; extra == 'tests'
Requires-Dist: pandocfilters ==1.5.0 ; extra == 'tests'
Requires-Dist: parso ==0.8.3 ; extra == 'tests'
Requires-Dist: pathtools ==0.1.2 ; extra == 'tests'
Requires-Dist: pexpect ==4.8.0 ; extra == 'tests'
Requires-Dist: pickleshare ==0.7.5 ; extra == 'tests'
Requires-Dist: pillow ==9.3.0 ; extra == 'tests'
Requires-Dist: pkgutil-resolve-name ==1.3.10 ; extra == 'tests'
Requires-Dist: platformdirs ==3.5.3 ; extra == 'tests'
Requires-Dist: pluggy ==1.0.0 ; extra == 'tests'
Requires-Dist: port-for ==0.7.0 ; extra == 'tests'
Requires-Dist: prometheus-client ==0.17.0 ; extra == 'tests'
Requires-Dist: prompt-toolkit ==3.0.38 ; extra == 'tests'
Requires-Dist: protobuf ==4.23.3 ; extra == 'tests'
Requires-Dist: psutil ==5.9.5 ; extra == 'tests'
Requires-Dist: psycopg[binary] ==3.1.9 ; extra == 'tests'
Requires-Dist: psycopg-binary ==3.1.9 ; extra == 'tests'
Requires-Dist: psycopg2-binary ==2.9.6 ; extra == 'tests'
Requires-Dist: ptyprocess ==0.7.0 ; extra == 'tests'
Requires-Dist: pure-eval ==0.2.2 ; extra == 'tests'
Requires-Dist: pyarrow ==7.0.0 ; extra == 'tests'
Requires-Dist: pycparser ==2.21 ; extra == 'tests'
Requires-Dist: pydicom ==2.3.1 ; extra == 'tests'
Requires-Dist: pygments ==2.15.1 ; extra == 'tests'
Requires-Dist: pyjwt ==2.7.0 ; extra == 'tests'
Requires-Dist: pyopenssl ==23.2.0 ; extra == 'tests'
Requires-Dist: pyparsing ==3.0.9 ; extra == 'tests'
Requires-Dist: pyproject-api ==1.5.2 ; extra == 'tests'
Requires-Dist: pyrsistent ==0.19.3 ; extra == 'tests'
Requires-Dist: pysocks ==1.7.1 ; extra == 'tests'
Requires-Dist: pytest ==7.3.2 ; extra == 'tests'
Requires-Dist: pytest-aiohttp ==1.0.4 ; extra == 'tests'
Requires-Dist: pytest-asyncio ==0.21.0 ; extra == 'tests'
Requires-Dist: pytest-cov ==4.1.0 ; extra == 'tests'
Requires-Dist: pytest-custom-exit-code ==0.3.0 ; extra == 'tests'
Requires-Dist: pytest-flakefinder ==1.1.0 ; extra == 'tests'
Requires-Dist: pytest-flask ==1.2.0 ; extra == 'tests'
Requires-Dist: pytest-httpx ==0.22.0 ; extra == 'tests'
Requires-Dist: pytest-lazy-fixture ==0.6.3 ; extra == 'tests'
Requires-Dist: pytest-mock ==3.10.0 ; extra == 'tests'
Requires-Dist: pytest-postgresql ==5.0.0 ; extra == 'tests'
Requires-Dist: pytest-randomly ==3.12.0 ; extra == 'tests'
Requires-Dist: pytest-timeout ==2.1.0 ; extra == 'tests'
Requires-Dist: pytest-xdist[psutil] ==3.3.1 ; extra == 'tests'
Requires-Dist: python-dateutil ==2.8.2 ; extra == 'tests'
Requires-Dist: python-dotenv ==1.0.0 ; extra == 'tests'
Requires-Dist: python-gdcm ==3.0.22 ; extra == 'tests'
Requires-Dist: python-json-logger ==2.0.7 ; extra == 'tests'
Requires-Dist: pytz ==2023.3 ; extra == 'tests'
Requires-Dist: pyyaml ==6.0.1 ; extra == 'tests'
Requires-Dist: pyzmq ==25.1.0 ; extra == 'tests'
Requires-Dist: querystring-parser ==1.2.4 ; extra == 'tests'
Requires-Dist: requests ==2.31.0 ; extra == 'tests'
Requires-Dist: requests-oauthlib ==1.3.1 ; extra == 'tests'
Requires-Dist: requests-toolbelt ==1.0.0 ; extra == 'tests'
Requires-Dist: responses ==0.23.1 ; extra == 'tests'
Requires-Dist: rfc3339-validator ==0.1.4 ; extra == 'tests'
Requires-Dist: rfc3986-validator ==0.1.1 ; extra == 'tests'
Requires-Dist: rfc3987 ==1.3.8 ; extra == 'tests'
Requires-Dist: s3transfer ==0.6.1 ; extra == 'tests'
Requires-Dist: scikit-learn ==1.2.2 ; extra == 'tests'
Requires-Dist: scipy ==1.10.1 ; extra == 'tests'
Requires-Dist: selenium ==4.2.0 ; extra == 'tests'
Requires-Dist: send2trash ==1.8.2 ; extra == 'tests'
Requires-Dist: sentry-sdk ==1.25.1 ; extra == 'tests'
Requires-Dist: setproctitle ==1.3.2 ; extra == 'tests'
Requires-Dist: simplejson ==3.19.1 ; extra == 'tests'
Requires-Dist: six ==1.16.0 ; extra == 'tests'
Requires-Dist: smmap ==5.0.0 ; extra == 'tests'
Requires-Dist: sniffio ==1.3.0 ; extra == 'tests'
Requires-Dist: sortedcontainers ==2.4.0 ; extra == 'tests'
Requires-Dist: soupsieve ==2.4.1 ; extra == 'tests'
Requires-Dist: sqlalchemy ==1.4.48 ; extra == 'tests'
Requires-Dist: sqlparse ==0.4.4 ; extra == 'tests'
Requires-Dist: stack-data ==0.6.2 ; extra == 'tests'
Requires-Dist: swagger-spec-validator ==3.0.3 ; extra == 'tests'
Requires-Dist: tabulate ==0.9.0 ; extra == 'tests'
Requires-Dist: terminado ==0.17.1 ; extra == 'tests'
Requires-Dist: testbook ==0.4.2 ; extra == 'tests'
Requires-Dist: threadpoolctl ==3.1.0 ; extra == 'tests'
Requires-Dist: tinycss2 ==1.2.1 ; extra == 'tests'
Requires-Dist: toml ==0.10.2 ; extra == 'tests'
Requires-Dist: tomli ==2.0.1 ; extra == 'tests'
Requires-Dist: tornado ==6.3.2 ; extra == 'tests'
Requires-Dist: tox ==4.6.0 ; extra == 'tests'
Requires-Dist: traitlets ==5.9.0 ; extra == 'tests'
Requires-Dist: trio ==0.22.0 ; extra == 'tests'
Requires-Dist: trio-websocket ==0.10.3 ; extra == 'tests'
Requires-Dist: types-pyyaml ==6.0.12.10 ; extra == 'tests'
Requires-Dist: typing-extensions ==4.6.3 ; extra == 'tests'
Requires-Dist: uri-template ==1.2.0 ; extra == 'tests'
Requires-Dist: urllib3[secure,socks] ==1.26.16 ; extra == 'tests'
Requires-Dist: urllib3-secure-extra ==0.1.0 ; extra == 'tests'
Requires-Dist: virtualenv ==20.23.0 ; extra == 'tests'
Requires-Dist: wandb ==0.15.4 ; extra == 'tests'
Requires-Dist: wcwidth ==0.2.6 ; extra == 'tests'
Requires-Dist: webcolors ==1.13 ; extra == 'tests'
Requires-Dist: webencodings ==0.5.1 ; extra == 'tests'
Requires-Dist: websocket-client ==1.5.3 ; extra == 'tests'
Requires-Dist: werkzeug ==2.3.6 ; extra == 'tests'
Requires-Dist: wsproto ==1.2.0 ; extra == 'tests'
Requires-Dist: yarl ==1.9.2 ; extra == 'tests'
Requires-Dist: zipp ==3.15.0 ; extra == 'tests'
Requires-Dist: ipython ==8.12.2 ; (python_version < "3.9") and extra == 'tests'
Provides-Extra: tutorials
Requires-Dist: anyio ==3.7.0 ; extra == 'tutorials'
Requires-Dist: appnope ==0.1.3 ; extra == 'tutorials'
Requires-Dist: argon2-cffi ==21.3.0 ; extra == 'tutorials'
Requires-Dist: argon2-cffi-bindings ==21.2.0 ; extra == 'tutorials'
Requires-Dist: arrow ==1.2.3 ; extra == 'tutorials'
Requires-Dist: asttokens ==2.2.1 ; extra == 'tutorials'
Requires-Dist: attrs ==23.1.0 ; extra == 'tutorials'
Requires-Dist: backcall ==0.2.0 ; extra == 'tutorials'
Requires-Dist: beautifulsoup4 ==4.12.2 ; extra == 'tutorials'
Requires-Dist: bleach ==6.0.0 ; extra == 'tutorials'
Requires-Dist: cffi ==1.15.1 ; extra == 'tutorials'
Requires-Dist: comm ==0.1.3 ; extra == 'tutorials'
Requires-Dist: contourpy ==1.1.0 ; extra == 'tutorials'
Requires-Dist: cycler ==0.11.0 ; extra == 'tutorials'
Requires-Dist: debugpy ==1.6.7 ; extra == 'tutorials'
Requires-Dist: decorator ==5.1.1 ; extra == 'tutorials'
Requires-Dist: defusedxml ==0.7.1 ; extra == 'tutorials'
Requires-Dist: exceptiongroup ==1.1.1 ; extra == 'tutorials'
Requires-Dist: executing ==1.2.0 ; extra == 'tutorials'
Requires-Dist: fastjsonschema ==2.17.1 ; extra == 'tutorials'
Requires-Dist: fonttools ==4.40.0 ; extra == 'tutorials'
Requires-Dist: fqdn ==1.5.1 ; extra == 'tutorials'
Requires-Dist: idna ==3.4 ; extra == 'tutorials'
Requires-Dist: importlib-metadata ==6.6.0 ; extra == 'tutorials'
Requires-Dist: importlib-resources ==5.12.0 ; extra == 'tutorials'
Requires-Dist: ipykernel ==6.23.2 ; extra == 'tutorials'
Requires-Dist: ipython-genutils ==0.2.0 ; extra == 'tutorials'
Requires-Dist: ipywidgets ==8.0.6 ; extra == 'tutorials'
Requires-Dist: isoduration ==20.11.0 ; extra == 'tutorials'
Requires-Dist: jedi ==0.18.2 ; extra == 'tutorials'
Requires-Dist: jinja2 ==3.1.2 ; extra == 'tutorials'
Requires-Dist: jsonpointer ==2.3 ; extra == 'tutorials'
Requires-Dist: jsonschema[format-nongpl] ==4.17.3 ; extra == 'tutorials'
Requires-Dist: jupyter-client ==8.2.0 ; extra == 'tutorials'
Requires-Dist: jupyter-contrib-core ==0.4.2 ; extra == 'tutorials'
Requires-Dist: jupyter-contrib-nbextensions ==0.7.0 ; extra == 'tutorials'
Requires-Dist: jupyter-core ==5.3.1 ; extra == 'tutorials'
Requires-Dist: jupyter-events ==0.6.3 ; extra == 'tutorials'
Requires-Dist: jupyter-highlight-selected-word ==0.2.0 ; extra == 'tutorials'
Requires-Dist: jupyter-nbextensions-configurator ==0.6.3 ; extra == 'tutorials'
Requires-Dist: jupyter-server ==2.6.0 ; extra == 'tutorials'
Requires-Dist: jupyter-server-terminals ==0.4.4 ; extra == 'tutorials'
Requires-Dist: jupyterlab-pygments ==0.2.2 ; extra == 'tutorials'
Requires-Dist: jupyterlab-widgets ==3.0.7 ; extra == 'tutorials'
Requires-Dist: jupytext ==1.14.6 ; extra == 'tutorials'
Requires-Dist: kiwisolver ==1.4.4 ; extra == 'tutorials'
Requires-Dist: lxml ==4.9.2 ; extra == 'tutorials'
Requires-Dist: markdown-it-py ==2.2.0 ; extra == 'tutorials'
Requires-Dist: markupsafe ==2.1.3 ; extra == 'tutorials'
Requires-Dist: matplotlib ==3.7.1 ; extra == 'tutorials'
Requires-Dist: matplotlib-inline ==0.1.6 ; extra == 'tutorials'
Requires-Dist: mdit-py-plugins ==0.4.0 ; extra == 'tutorials'
Requires-Dist: mdurl ==0.1.2 ; extra == 'tutorials'
Requires-Dist: mistune ==2.0.5 ; extra == 'tutorials'
Requires-Dist: nbclassic ==1.0.0 ; extra == 'tutorials'
Requires-Dist: nbclient ==0.8.0 ; extra == 'tutorials'
Requires-Dist: nbconvert ==7.5.0 ; extra == 'tutorials'
Requires-Dist: nbformat ==5.9.0 ; extra == 'tutorials'
Requires-Dist: nest-asyncio ==1.5.6 ; extra == 'tutorials'
Requires-Dist: notebook ==6.5.4 ; extra == 'tutorials'
Requires-Dist: notebook-shim ==0.2.3 ; extra == 'tutorials'
Requires-Dist: numpy ==1.24.3 ; extra == 'tutorials'
Requires-Dist: overrides ==7.3.1 ; extra == 'tutorials'
Requires-Dist: packaging ==23.1 ; extra == 'tutorials'
Requires-Dist: pandocfilters ==1.5.0 ; extra == 'tutorials'
Requires-Dist: parso ==0.8.3 ; extra == 'tutorials'
Requires-Dist: pexpect ==4.8.0 ; extra == 'tutorials'
Requires-Dist: pickleshare ==0.7.5 ; extra == 'tutorials'
Requires-Dist: pillow ==9.3.0 ; extra == 'tutorials'
Requires-Dist: pkgutil-resolve-name ==1.3.10 ; extra == 'tutorials'
Requires-Dist: platformdirs ==3.5.3 ; extra == 'tutorials'
Requires-Dist: prometheus-client ==0.17.0 ; extra == 'tutorials'
Requires-Dist: prompt-toolkit ==3.0.38 ; extra == 'tutorials'
Requires-Dist: psutil ==5.9.5 ; extra == 'tutorials'
Requires-Dist: ptyprocess ==0.7.0 ; extra == 'tutorials'
Requires-Dist: pure-eval ==0.2.2 ; extra == 'tutorials'
Requires-Dist: pycparser ==2.21 ; extra == 'tutorials'
Requires-Dist: pygments ==2.15.1 ; extra == 'tutorials'
Requires-Dist: pyparsing ==3.0.9 ; extra == 'tutorials'
Requires-Dist: pyrsistent ==0.19.3 ; extra == 'tutorials'
Requires-Dist: python-dateutil ==2.8.2 ; extra == 'tutorials'
Requires-Dist: python-json-logger ==2.0.7 ; extra == 'tutorials'
Requires-Dist: pyyaml ==6.0.1 ; extra == 'tutorials'
Requires-Dist: pyzmq ==25.1.0 ; extra == 'tutorials'
Requires-Dist: rfc3339-validator ==0.1.4 ; extra == 'tutorials'
Requires-Dist: rfc3986-validator ==0.1.1 ; extra == 'tutorials'
Requires-Dist: send2trash ==1.8.2 ; extra == 'tutorials'
Requires-Dist: six ==1.16.0 ; extra == 'tutorials'
Requires-Dist: sniffio ==1.3.0 ; extra == 'tutorials'
Requires-Dist: soupsieve ==2.4.1 ; extra == 'tutorials'
Requires-Dist: stack-data ==0.6.2 ; extra == 'tutorials'
Requires-Dist: terminado ==0.17.1 ; extra == 'tutorials'
Requires-Dist: tinycss2 ==1.2.1 ; extra == 'tutorials'
Requires-Dist: toml ==0.10.2 ; extra == 'tutorials'
Requires-Dist: tornado ==6.3.2 ; extra == 'tutorials'
Requires-Dist: tqdm ==4.65.0 ; extra == 'tutorials'
Requires-Dist: traitlets ==5.9.0 ; extra == 'tutorials'
Requires-Dist: typing-extensions ==4.6.3 ; extra == 'tutorials'
Requires-Dist: uri-template ==1.2.0 ; extra == 'tutorials'
Requires-Dist: wcwidth ==0.2.6 ; extra == 'tutorials'
Requires-Dist: webcolors ==1.13 ; extra == 'tutorials'
Requires-Dist: webencodings ==0.5.1 ; extra == 'tutorials'
Requires-Dist: websocket-client ==1.5.3 ; extra == 'tutorials'
Requires-Dist: widgetsnbextension ==4.0.7 ; extra == 'tutorials'
Requires-Dist: zipp ==3.15.0 ; extra == 'tutorials'
Requires-Dist: ipython ==8.12.2 ; (python_version < "3.9") and extra == 'tutorials'

<div align="center">
<img src="https://bitfount-web-resources.s3.eu-west-2.amazonaws.com/bitfount_logo_horizontal.png" width="600px">

**Federated learning and data analytics that just works**

---

</br>
<!-- Github workflow badges are case sensitive - the name must match the name of the workflow exactly -->

![Python versions](https://img.shields.io/pypi/pyversions/bitfount)
[![PyPI Latest Release](https://img.shields.io/pypi/v/bitfount.svg)](https://pypi.org/project/bitfount/)
[![PyPI Downloads](https://pepy.tech/badge/bitfount)](https://pepy.tech/project/bitfount)
![](https://github.com/bitfount/bitfount/workflows/CI/badge.svg?branch=develop)
![](https://github.com/bitfount/bitfount/workflows/tutorials/badge.svg?branch=develop)
[![codecov](https://codecov.io/gh/bitfount/bitfount/branch/develop/graph/badge.svg?token=r1hulrgehK)](https://codecov.io/gh/bitfount/bitfount)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![security: bandit](https://img.shields.io/badge/security-bandit-yellow.svg)](https://github.com/PyCQA/bandit)
[![mypy type checked](https://img.shields.io/badge/mypy-checked-blue)](https://github.com/python/mypy)
[![flake8](https://img.shields.io/badge/linter-flake8-success)](https://github.com/PyCQA/flake8)
[![license](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/bitfount/bitfount/blob/develop/LICENSE)

<!-- ![docs-coverage](interrogate.svg) -->

</div>

## Table of Contents

- [Using the Docker images](#using-the-docker-images)
- [Running the Python code](#running-the-python-code)
  - [Installation](#installation)
  - [Getting started (Tutorials)](#getting-started-tutorials)
  - [Federated training scripts](#federated-training-scripts)
  - [Basic Local Usage](#basic-local-usage)
- [License](#license)

## Using the Docker images

There are two docker images, one for running a Pod (`ghcr.io/bitfount/pod:stable`),
and another for running a modelling task (`ghcr.io/bitfount/modeller:stable`).

Both of the images require a `config.yaml` file to be provided to them,
by default they will try to load it from `/mount/config/config.yaml` inside the docker container.
You can provide this file easily by mounting/binding a volume to the container,
how you do this may vary depending on your platform/environment (Docker/docker-compose/ECS),
if you have any problems doing this then feel free to reach out to us.

Alternative you could copy a config file into a stopped container using [docker cp](https://docs.docker.com/engine/reference/commandline/cp/).

If you're using a CSV data source then you'll also need to mount your data to the container,
this will need to be mounted at the path specified in your config, for simplicity it's easiest
put your config and your CSV in the same directory and then mount it to the container.

Once your container is running you will need to check the logs and complete the login step,
allowing your container to authenticate with Bitfount.
The process is the same as when running locally (e.g. the tutorials),
except that we can't open the login page automatically for you.

## Running the Python code

### Installation

#### Where to get it

Binary installers for the latest released version are available at the [Python
Package Index (PyPI)](https://pypi.org/project/bitfount).

`pip install bitfount`

For DICOM support, you will need to install the DICOM extras:

`pip install 'bitfount[dicom]'`

If you want to use differential privacy (DP), you will need to install the DP extras:

`pip install 'bitfount[dp]'`

Ensure you are using python 3.8 or 3.9. The DP extra is not supported on 3.10.

If you are planning on using the `bitfount` package with Jupyter Notebooks, we recommend you install the splinter package `bitfount[tutorials]` which will make sure you are running compatible jupyter dependencies.

`pip install 'bitfount[tutorials]'`

#### Installation from sources

To install `bitfount` from source you need to create a python virtual environment.

In the `bitfount` directory (same one where you found this file after cloning the git repo), execute:

`pip install -r requirements/requirements.in`

These requirements are set to permissive ranges but are not guaranteed to work for all releases, especially the latest versions. For a pinned version of these requirements which are guaranteed to work, run the following command instead:

```bash
#!/bin/bash
PYTHON_VERSION=$(python -c "import platform; print(''.join(platform.python_version_tuple()[:2]))")
pip install -r requirements/${PYTHON_VERSION}/requirements.txt
```

To be able to use differential privacy (DP), you will need to additionally install the DP requirements. Please note that this is only compatible with Python version 3.8 and 3.9. Also, it is restricted to non-arm architectures:

```bash
#!/bin/bash
PYTHON_VERSION=$(python -c "import platform; print(''.join(platform.python_version_tuple()[:2]))")
PLATFORM_PROCESSOR=$(python -c "import platform; print(platform.processor())")

if [[ ${PYTHON_VERSION} == "38" || ${PYTHON_VERSION} == "39" ]] && [[ ${PLATFORM_PROCESSOR} != "arm" ]]; then
    pip install -r requirements/${PYTHON_VERSION}/differential_privacy/requirements-dp.txt
fi
```

For MacOS you also need to install `libomp`:

`brew install libomp`

### Getting started (Tutorials)

In order to run the tutorials, you also need to install the tutorial requirements:

```bash
#!/bin/bash
PYTHON_VERSION=$(python -c "import platform; print(''.join(platform.python_version_tuple()[:2]))")
pip install -r requirements/${PYTHON_VERSION}/requirements-tutorial.txt
```

To get started using the Bitfount package in a federated setting, we recommend
that you start with our tutorials. Run `jupyter notebook`and open up the first
tutorial in the "Connecting Data & Creating Pods folder: `running_a_pod.ipynb`

### Federated training scripts

Some simple scripts have been provided to run a Pod or Modelling job from a config file.

> ⚠️ If you are running from a source install (such as from `git clone`) you will
> need to use <span style="white-space: nowrap">`python -m scripts.<script_name>`</span>
> rather than use `bitfount <script_name>` directly.

To run a pod:

`bitfount run_pod --path_to_config_yaml=<CONFIG_FILE>`

To run a modelling job:

`bitfount run_modeller --path_to_config_yaml=<CONFIG_FILE>`

### Basic Local Usage

As well as providing the ability to use data in remote pods, this package also enables local ML training. Some example code for this purpose is given below.

**1\. Import bitfount**

```python
import bitfount as bf
```

**2\. Create DataSource and load data**

```python
census_income = bf.CSVSource(
    path="https://bitfount-hosted-downloads.s3.eu-west-2.amazonaws.com/bitfount-tutorials/census_income.csv",
    ignore_cols=["fnlwgt"],
)
census_income.load_data()
```

**3\. Create Schema**

```python
schema = bf.BitfountSchema(
    census_income,
    table_name="census_income",
    force_stypes={
        "census_income": {
            "categorical":[
                "TARGET",
                "workclass",
                "marital-status",
                "occupation",
                "relationship",
                "race",
                "native-country",
                "gender",
                "education"
            ]
        }
    }
)
```

**4\. Transform Data**

```python
clean_data = bf.CleanDataTransformation()
processor = bf.TransformationProcessor([clean_data], schema.get_table_schema("census_income"))
census_income.data = processor.transform(census_income.data)
schema.add_datasource_tables(census_income, table_name="census_income")
```

**5\. Create DataStructure**

```python
census_income_data_structure=bf.DataStructure(
  table="census_income",
  target="TARGET",
)
```

**6\. Create and Train Model**

```python
nn = bf.PyTorchTabularClassifier(
    datastructure=census_income_data_structure,
    schema=schema,
    epochs=2,
    batch_size=256,
    optimizer=bf.Optimizer("RAdam", {"lr": 0.001}),
)
nn.fit(census_income)
nn.serialize("demo_task_model.pt")
```

**7\. Evaluate**

```python
preds, target = nn.evaluate()
metrics = bf.MetricCollection.create_from_model(nn)
results = metrics.compute(target, preds)
print(results)
```

**8\. Assert results**

```python
import numpy as np
assert nn._validation_results[-1]["validation_loss"] is not np.nan
assert results["AUC"] > 0.7
```

## License

The license for this software is available in the `LICENSE` file.
This can be found in the Github Repository, as well as inside the Docker image.
