<div align="center">
<img src="https://hub.bitfount.com/_auth/static/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 -->
[](https://pypi.org/project/bitfount/)
[](https://pepy.tech/project/bitfount)
[](https://codecov.io/gh/bitfount/bitfount)
[](https://github.com/psf/black)
[](https://github.com/PyCQA/bandit)
[](https://github.com/python/mypy)
[](https://github.com/PyCQA/flake8)
[](https://github.com/bitfount/bitfount/blob/develop/LICENSE)
<!--  -->
</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)
- [License](#license)
## Using the Docker images
There is a docker image for running a pod (`ghcr.io/bitfount/pod:stable`).
The image requires a `config.yaml` file to be provided to them,
by default it 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`
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
```
For MacOS you may 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>`
## 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.
Raw data
{
"_id": null,
"home_page": "https://github.com/bitfount/bitfount",
"name": "bitfount",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.11,>=3.10",
"maintainer_email": null,
"keywords": "federated learning, privacy, AI, machine learning",
"author": "Bitfount",
"author_email": "info@bitfount.com",
"download_url": "https://files.pythonhosted.org/packages/18/ea/62dfe6715ff02b0b5150217e5f7c4ab6424f6dfd738e303f8aadf68a5d63/bitfount-5.0.0.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n<img src=\"https://hub.bitfount.com/_auth/static/bitfount_logo_horizontal.png\" width=\"600px\">\n\n**Federated learning and data analytics that just works**\n\n---\n\n</br>\n<!-- Github workflow badges are case sensitive - the name must match the name of the workflow exactly -->\n\n\n[](https://pypi.org/project/bitfount/)\n[](https://pepy.tech/project/bitfount)\n\n\n[](https://codecov.io/gh/bitfount/bitfount)\n[](https://github.com/psf/black)\n[](https://github.com/PyCQA/bandit)\n[](https://github.com/python/mypy)\n[](https://github.com/PyCQA/flake8)\n[](https://github.com/bitfount/bitfount/blob/develop/LICENSE)\n\n<!--  -->\n\n</div>\n\n## Table of Contents\n\n- [Using the Docker images](#using-the-docker-images)\n- [Running the Python code](#running-the-python-code)\n - [Installation](#installation)\n - [Getting started (Tutorials)](#getting-started-tutorials)\n - [Federated training scripts](#federated-training-scripts)\n- [License](#license)\n\n## Using the Docker images\n\nThere is a docker image for running a pod (`ghcr.io/bitfount/pod:stable`).\n\nThe image requires a `config.yaml` file to be provided to them,\nby default it will try to load it from `/mount/config/config.yaml` inside the docker container.\nYou can provide this file easily by mounting/binding a volume to the container,\nhow you do this may vary depending on your platform/environment (Docker/docker-compose/ECS),\nif you have any problems doing this then feel free to reach out to us.\n\nAlternative you could copy a config file into a stopped container using [docker cp](https://docs.docker.com/engine/reference/commandline/cp/).\n\nIf you're using a CSV data source then you'll also need to mount your data to the container,\nthis will need to be mounted at the path specified in your config, for simplicity it's easiest\nput your config and your CSV in the same directory and then mount it to the container.\n\nOnce your container is running you will need to check the logs and complete the login step,\nallowing your container to authenticate with Bitfount.\nThe process is the same as when running locally (e.g. the tutorials),\nexcept that we can't open the login page automatically for you.\n\n## Running the Python code\n\n### Installation\n\n#### Where to get it\n\nBinary installers for the latest released version are available at the [Python\nPackage Index (PyPI)](https://pypi.org/project/bitfount).\n\n`pip install bitfount`\n\nIf 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.\n\n`pip install 'bitfount[tutorials]'`\n\n#### Installation from sources\n\nTo install `bitfount` from source you need to create a python virtual environment.\n\nIn the `bitfount` directory (same one where you found this file after cloning the git repo), execute:\n\n`pip install -r requirements/requirements.in`\n\nThese 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:\n\n```bash\n#!/bin/bash\nPYTHON_VERSION=$(python -c \"import platform; print(''.join(platform.python_version_tuple()[:2]))\")\npip install -r requirements/${PYTHON_VERSION}/requirements.txt\n```\n\nFor MacOS you may also need to install `libomp`:\n\n`brew install libomp`\n\n### Getting started (Tutorials)\n\nIn order to run the tutorials, you also need to install the tutorial requirements:\n\n```bash\n#!/bin/bash\nPYTHON_VERSION=$(python -c \"import platform; print(''.join(platform.python_version_tuple()[:2]))\")\npip install -r requirements/${PYTHON_VERSION}/requirements-tutorial.txt\n```\n\nTo get started using the Bitfount package in a federated setting, we recommend\nthat you start with our tutorials. Run `jupyter notebook`and open up the first\ntutorial in the \"Connecting Data & Creating Pods folder: `running_a_pod.ipynb`\n\n### Federated training scripts\n\nSome simple scripts have been provided to run a Pod or Modelling job from a config file.\n\n> \u26a0\ufe0f If you are running from a source install (such as from `git clone`) you will\n> need to use <span style=\"white-space: nowrap\">`python -m scripts.<script_name>`</span>\n> rather than use `bitfount <script_name>` directly.\n\nTo run a pod:\n\n`bitfount run_pod --path_to_config_yaml=<CONFIG_FILE>`\n\nTo run a modelling job:\n\n`bitfount run_modeller --path_to_config_yaml=<CONFIG_FILE>`\n\n## License\n\nThe license for this software is available in the `LICENSE` file.\nThis can be found in the Github Repository, as well as inside the Docker image.\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "Machine Learning and Federated Learning Library.",
"version": "5.0.0",
"project_urls": {
"Documentation": "https://docs.bitfount.com/",
"Homepage": "https://bitfount.com",
"Hub": "https://hub.bitfount.com",
"Source Code": "https://github.com/bitfount/bitfount/"
},
"split_keywords": [
"federated learning",
" privacy",
" ai",
" machine learning"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d6b9b4faf77d3f4800b6667581887e26ce4026774172a379e39650fa2d16d1ca",
"md5": "90760b491184821cd5ceb622b8a10520",
"sha256": "c23d207a744aff043a2c17396113d2894441c7a33dbee743231f5f638b9e9e0d"
},
"downloads": -1,
"filename": "bitfount-5.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "90760b491184821cd5ceb622b8a10520",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.11,>=3.10",
"size": 1751683,
"upload_time": "2024-12-18T11:22:11",
"upload_time_iso_8601": "2024-12-18T11:22:11.859544Z",
"url": "https://files.pythonhosted.org/packages/d6/b9/b4faf77d3f4800b6667581887e26ce4026774172a379e39650fa2d16d1ca/bitfount-5.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "18ea62dfe6715ff02b0b5150217e5f7c4ab6424f6dfd738e303f8aadf68a5d63",
"md5": "6d0f7cbf5ea81d307fcecb94f9a3890b",
"sha256": "7a1fa81e68187f38d63307f91ba40e497d3f1533f5533cc43bb5c019ee28a989"
},
"downloads": -1,
"filename": "bitfount-5.0.0.tar.gz",
"has_sig": false,
"md5_digest": "6d0f7cbf5ea81d307fcecb94f9a3890b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.11,>=3.10",
"size": 1569937,
"upload_time": "2024-12-18T11:22:14",
"upload_time_iso_8601": "2024-12-18T11:22:14.477687Z",
"url": "https://files.pythonhosted.org/packages/18/ea/62dfe6715ff02b0b5150217e5f7c4ab6424f6dfd738e303f8aadf68a5d63/bitfount-5.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-18 11:22:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "bitfount",
"github_project": "bitfount",
"github_not_found": true,
"lcname": "bitfount"
}
JSON
