vantage6 5.0.0a29__py3-none-any.whl → 5.0.0a34__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of vantage6 might be problematic. Click here for more details.
- vantage6/cli/__init__.py +5 -1
- vantage6/cli/algorithm/generate_algorithm_json.py +3 -11
- vantage6/cli/algostore/new.py +24 -46
- vantage6/cli/algostore/start.py +33 -67
- vantage6/cli/algostore/stop.py +75 -40
- vantage6/cli/common/new.py +60 -0
- vantage6/cli/common/start.py +17 -223
- vantage6/cli/common/stop.py +1 -1
- vantage6/cli/common/utils.py +212 -16
- vantage6/cli/configuration_manager.py +65 -0
- vantage6/cli/configuration_wizard.py +95 -76
- vantage6/cli/context/algorithm_store.py +8 -7
- vantage6/cli/context/base_server.py +22 -30
- vantage6/cli/context/node.py +11 -2
- vantage6/cli/context/server.py +17 -8
- vantage6/cli/globals.py +12 -11
- vantage6/cli/node/common/__init__.py +1 -1
- vantage6/cli/node/create_private_key.py +9 -6
- vantage6/cli/node/set_api_key.py +7 -4
- vantage6/cli/node/start.py +1 -1
- vantage6/cli/node/stop.py +7 -7
- vantage6/cli/server/import_.py +1 -2
- vantage6/cli/server/list.py +0 -3
- vantage6/cli/server/new.py +13 -51
- vantage6/cli/server/shell.py +1 -1
- vantage6/cli/server/start.py +17 -17
- vantage6/cli/server/stop.py +64 -15
- vantage6/cli/template/algo_store_config.j2 +195 -22
- vantage6/cli/template/server_config.j2 +255 -33
- vantage6-5.0.0a34.dist-info/METADATA +54 -0
- {vantage6-5.0.0a29.dist-info → vantage6-5.0.0a34.dist-info}/RECORD +33 -42
- {vantage6-5.0.0a29.dist-info → vantage6-5.0.0a34.dist-info}/WHEEL +1 -2
- vantage6-5.0.0a34.dist-info/entry_points.txt +2 -0
- tests_cli/__init__.py +0 -0
- tests_cli/test_client_script.py +0 -23
- tests_cli/test_example.py +0 -7
- tests_cli/test_node_cli.py +0 -452
- tests_cli/test_server_cli.py +0 -180
- tests_cli/test_wizard.py +0 -141
- vantage6/cli/__build__ +0 -1
- vantage6/cli/_version.py +0 -23
- vantage6/cli/template/server_import_config.j2 +0 -31
- vantage6-5.0.0a29.dist-info/METADATA +0 -238
- vantage6-5.0.0a29.dist-info/entry_points.txt +0 -5
- vantage6-5.0.0a29.dist-info/top_level.txt +0 -2
tests_cli/test_wizard.py
DELETED
|
@@ -1,141 +0,0 @@
|
|
|
1
|
-
import unittest
|
|
2
|
-
from pathlib import Path
|
|
3
|
-
from unittest.mock import MagicMock, patch
|
|
4
|
-
|
|
5
|
-
from vantage6.common.globals import InstanceType, NodePolicy
|
|
6
|
-
|
|
7
|
-
from vantage6.cli.configuration_wizard import (
|
|
8
|
-
configuration_wizard,
|
|
9
|
-
node_configuration_questionaire,
|
|
10
|
-
select_configuration_questionaire,
|
|
11
|
-
server_configuration_questionaire,
|
|
12
|
-
)
|
|
13
|
-
|
|
14
|
-
module_path = "vantage6.cli.configuration_wizard"
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
class WizardTest(unittest.TestCase):
|
|
18
|
-
@staticmethod
|
|
19
|
-
def prompts(*args, **kwargs):
|
|
20
|
-
result = {}
|
|
21
|
-
for arg in args[0]:
|
|
22
|
-
name = arg["name"]
|
|
23
|
-
if name == "default": # default db path
|
|
24
|
-
result[name] = "/some/path/db.sqlite"
|
|
25
|
-
else:
|
|
26
|
-
if "default" in arg:
|
|
27
|
-
result[name] = arg["default"]
|
|
28
|
-
else:
|
|
29
|
-
result[name] = None
|
|
30
|
-
return result
|
|
31
|
-
|
|
32
|
-
@patch("vantage6.cli.configuration_wizard.NodeClient.authenticate")
|
|
33
|
-
def test_node_wizard(self, authenticate):
|
|
34
|
-
"""An error is printed when docker is not running"""
|
|
35
|
-
authenticate.return_value = None
|
|
36
|
-
|
|
37
|
-
with patch(f"{module_path}.q") as q:
|
|
38
|
-
q.unsafe_prompt.side_effect = self.prompts
|
|
39
|
-
q.confirm.return_value.unsafe_ask.side_effect = [
|
|
40
|
-
True, # add a database
|
|
41
|
-
False, # don't enable two-factor authentication
|
|
42
|
-
True, # add VPN server
|
|
43
|
-
True, # add algorithm policies
|
|
44
|
-
True, # add single algorithms to allowed_algorithms
|
|
45
|
-
"some-image", # algorithm image to whitelist
|
|
46
|
-
False, # don't add another algorithm image
|
|
47
|
-
True, # add algorithm stores to allowed_algorithm_stores
|
|
48
|
-
"some-store", # algorithm store to whitelist
|
|
49
|
-
False, # don't add another algorithm store
|
|
50
|
-
False, # answer question on combining policies on store level and
|
|
51
|
-
# single algorithm level
|
|
52
|
-
False, # don't abort if no server connection is made to pull
|
|
53
|
-
# collaboration settings
|
|
54
|
-
True, # Enable encryption
|
|
55
|
-
]
|
|
56
|
-
dirs = MagicMock(data="/")
|
|
57
|
-
config = node_configuration_questionaire(dirs, "iknl")
|
|
58
|
-
|
|
59
|
-
keys = [
|
|
60
|
-
"api_key",
|
|
61
|
-
"server_url",
|
|
62
|
-
"port",
|
|
63
|
-
"api_path",
|
|
64
|
-
"task_dir",
|
|
65
|
-
"databases",
|
|
66
|
-
"logging",
|
|
67
|
-
"encryption",
|
|
68
|
-
"vpn_subnet",
|
|
69
|
-
]
|
|
70
|
-
for key in keys:
|
|
71
|
-
self.assertIn(key, config)
|
|
72
|
-
nested_keys = [
|
|
73
|
-
["policies", NodePolicy.ALLOWED_ALGORITHMS.value],
|
|
74
|
-
["policies", NodePolicy.ALLOWED_ALGORITHM_STORES.value],
|
|
75
|
-
]
|
|
76
|
-
for nesting in nested_keys:
|
|
77
|
-
current_config = config
|
|
78
|
-
for key in nesting:
|
|
79
|
-
self.assertIn(key, current_config)
|
|
80
|
-
current_config = current_config[key]
|
|
81
|
-
|
|
82
|
-
def test_server_wizard(self):
|
|
83
|
-
with patch(f"{module_path}.q") as q:
|
|
84
|
-
q.unsafe_prompt.side_effect = self.prompts
|
|
85
|
-
q.confirm.return_value.unsafe_ask.side_effect = [
|
|
86
|
-
True,
|
|
87
|
-
True,
|
|
88
|
-
True,
|
|
89
|
-
True,
|
|
90
|
-
True,
|
|
91
|
-
True,
|
|
92
|
-
False,
|
|
93
|
-
]
|
|
94
|
-
|
|
95
|
-
config = server_configuration_questionaire("vantage6")
|
|
96
|
-
|
|
97
|
-
keys = [
|
|
98
|
-
"description",
|
|
99
|
-
"ip",
|
|
100
|
-
"port",
|
|
101
|
-
"api_path",
|
|
102
|
-
"uri",
|
|
103
|
-
"allow_drop_all",
|
|
104
|
-
"logging",
|
|
105
|
-
"vpn_server",
|
|
106
|
-
"rabbitmq",
|
|
107
|
-
"two_factor_auth",
|
|
108
|
-
"algorithm_stores",
|
|
109
|
-
]
|
|
110
|
-
|
|
111
|
-
for key in keys:
|
|
112
|
-
self.assertIn(key, config)
|
|
113
|
-
|
|
114
|
-
@patch(f"{module_path}.node_configuration_questionaire")
|
|
115
|
-
@patch(f"{module_path}.server_configuration_questionaire")
|
|
116
|
-
@patch(f"{module_path}.ServerConfigurationManager")
|
|
117
|
-
@patch(f"{module_path}.NodeConfigurationManager")
|
|
118
|
-
@patch("vantage6.cli.configuration_wizard.AppContext")
|
|
119
|
-
def test_configuration_wizard_interface(
|
|
120
|
-
self, context, node_m, server_m, server_q, node_q
|
|
121
|
-
):
|
|
122
|
-
context.instance_folders.return_value = {"config": "/some/path/"}
|
|
123
|
-
|
|
124
|
-
file_ = configuration_wizard(InstanceType.NODE, "vtg6", False)
|
|
125
|
-
self.assertEqual(Path("/some/path/vtg6.yaml"), file_)
|
|
126
|
-
|
|
127
|
-
file_ = configuration_wizard(InstanceType.SERVER, "vtg6", True)
|
|
128
|
-
self.assertEqual(Path("/some/path/vtg6.yaml"), file_)
|
|
129
|
-
|
|
130
|
-
@patch("vantage6.cli.configuration_wizard.AppContext.available_configurations")
|
|
131
|
-
def test_select_configuration(self, available_configurations):
|
|
132
|
-
config = MagicMock()
|
|
133
|
-
config.name = "vtg6"
|
|
134
|
-
|
|
135
|
-
available_configurations.return_value = [[config], []]
|
|
136
|
-
|
|
137
|
-
with patch(f"{module_path}.q") as q:
|
|
138
|
-
q.select.return_value.unsafe_ask.return_value = "vtg6"
|
|
139
|
-
name = select_configuration_questionaire(InstanceType.NODE, True)
|
|
140
|
-
|
|
141
|
-
self.assertEqual(name, "vtg6")
|
vantage6/cli/__build__
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
29
|
vantage6/cli/_version.py
DELETED
|
@@ -1,23 +0,0 @@
|
|
|
1
|
-
import os
|
|
2
|
-
import json
|
|
3
|
-
|
|
4
|
-
here = os.path.abspath(os.path.dirname(__file__))
|
|
5
|
-
|
|
6
|
-
with open(os.path.join(here, "__build__")) as fp:
|
|
7
|
-
__build__ = json.load(fp)
|
|
8
|
-
|
|
9
|
-
# Module version
|
|
10
|
-
version_info = (5, 0, 0, "alpha", __build__, 0)
|
|
11
|
-
|
|
12
|
-
# Module version stage suffix map
|
|
13
|
-
_specifier_ = {"alpha": "a", "beta": "b", "candidate": "rc", "final": ""}
|
|
14
|
-
version = f"{version_info[0]}.{version_info[1]}.{version_info[2]}"
|
|
15
|
-
pre_release = (
|
|
16
|
-
""
|
|
17
|
-
if version_info[3] == "final"
|
|
18
|
-
else _specifier_[version_info[3]] + str(version_info[4])
|
|
19
|
-
)
|
|
20
|
-
post_release = "" if not version_info[5] else f".post{version_info[5]}"
|
|
21
|
-
|
|
22
|
-
# Module version accessible using thomas.__version__
|
|
23
|
-
__version__ = f"{version}{pre_release}{post_release}"
|
|
@@ -1,31 +0,0 @@
|
|
|
1
|
-
organizations:
|
|
2
|
-
{% for org in organizations %}
|
|
3
|
-
- name: {{ org['name'] }}
|
|
4
|
-
domain: iknl.nl
|
|
5
|
-
address1: Godebaldkwartier 419
|
|
6
|
-
address2:
|
|
7
|
-
zipcode: 3511DT
|
|
8
|
-
country: Netherlands
|
|
9
|
-
{% if org['make_admin'] %}
|
|
10
|
-
users:
|
|
11
|
-
- username: dev_admin
|
|
12
|
-
password: password
|
|
13
|
-
{% endif %}
|
|
14
|
-
public_key: LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUlJQ0lqQU5CZ2txaGtpRzl3MEJBUUVGQUFPQ0FnOEFNSUlDQ2dLQ0FnRUF2eU4wWVZhWWVZcHVWRVlpaDJjeQphTjdxQndCUnB5bVVibnRQNmw2Vk9OOGE1eGwxMmJPTlQyQ1hwSEVGUFhZQTFFZThQRFZwYnNQcVVKbUlseWpRCkgyN0NhZTlIL2lJbUNVNnViUXlnTzFsbG1KRTJQWDlTNXVxendVV3BXMmRxRGZFSHJLZTErUUlDRGtGSldmSEIKWkJkczRXMTBsMWlxK252dkZ4OWY3dk8xRWlLcVcvTGhQUS83Mm52YlZLMG9nRFNaUy9Jc1NnUlk5ZnJVU1FZUApFbGVZWUgwYmI5VUdlNUlYSHRMQjBkdVBjZUV4dXkzRFF5bXh2WTg3bTlkelJsN1NqaFBqWEszdUplSDAwSndjCk80TzJ0WDVod0lLL1hEQ3h4eCt4b3cxSDdqUWdXQ0FybHpodmdzUkdYUC9wQzEvL1hXaVZSbTJWZ3ZqaXNNaisKS2VTNWNaWWpkUkMvWkRNRW1QU29rS2Y4UnBZUk1lZk0xMWtETTVmaWZIQTlPcmY2UXEyTS9SMy90Mk92VDRlRgorUzVJeTd1QWk1N0ROUkFhejVWRHNZbFFxTU5QcUpKYlRtcGlYRWFpUHVLQitZVEdDSC90TXlrRG1JK1dpejNRCjh6SVo1bk1IUnhySFNqSWdWSFdwYnZlTnVaL1Q1aE95aE1uZHU0c3NpRkJyUXN5ZGc1RlVxR3lkdE1JMFJEVHcKSDVBc1ovaFlLeHdiUm1xTXhNcjFMaDFBaDB5SUlsZDZKREY5MkF1UlNTeDl0djNaVWRndEp5VVlYN29VZS9GKwpoUHVwVU4rdWVTUndGQjBiVTYwRXZQWTdVU2RIR1diVVIrRDRzTVQ4Wjk0UVl2S2ZCanU3ZXVKWSs0Mmd2Wm9jCitEWU9ZS05qNXFER2V5azErOE9aTXZNQ0F3RUFBUT09Ci0tLS0tRU5EIFBVQkxJQyBLRVktLS0tLQo=
|
|
15
|
-
{% endfor %}
|
|
16
|
-
collaborations:
|
|
17
|
-
- name: {{ collaboration['name'] }}
|
|
18
|
-
domain: iknl.nl
|
|
19
|
-
address1: Godebaldkwartier 419
|
|
20
|
-
address2:
|
|
21
|
-
zipcode: 3511DT
|
|
22
|
-
country: Netherlands
|
|
23
|
-
participants:
|
|
24
|
-
{% if collaboration['participants'] %}
|
|
25
|
-
{% for party in collaboration['participants'] %}
|
|
26
|
-
- name: {{ party['name'] }}
|
|
27
|
-
api_key: {{ party['api_key'] }}
|
|
28
|
-
{% endfor %}
|
|
29
|
-
{% endif %}
|
|
30
|
-
tasks: ['hello-world']
|
|
31
|
-
encrypted: false
|
|
@@ -1,238 +0,0 @@
|
|
|
1
|
-
Metadata-Version: 2.4
|
|
2
|
-
Name: vantage6
|
|
3
|
-
Version: 5.0.0a29
|
|
4
|
-
Summary: vantage6 command line interface
|
|
5
|
-
Home-page: https://github.com/vantage6/vantage6
|
|
6
|
-
Requires-Python: >=3.13
|
|
7
|
-
Description-Content-Type: text/markdown
|
|
8
|
-
Requires-Dist: click==8.1.3
|
|
9
|
-
Requires-Dist: colorama==0.4.6
|
|
10
|
-
Requires-Dist: copier==9.2.0
|
|
11
|
-
Requires-Dist: docker==7.1.0
|
|
12
|
-
Requires-Dist: ipython==8.10.0
|
|
13
|
-
Requires-Dist: jinja2==3.1.6
|
|
14
|
-
Requires-Dist: kubernetes==28.1.0
|
|
15
|
-
Requires-Dist: pandas>=2.2.3
|
|
16
|
-
Requires-Dist: questionary==1.10.0
|
|
17
|
-
Requires-Dist: rich==13.5.2
|
|
18
|
-
Requires-Dist: schema==0.7.5
|
|
19
|
-
Requires-Dist: sqlalchemy==2.0.37
|
|
20
|
-
Requires-Dist: vantage6-common==5.0.0a29
|
|
21
|
-
Requires-Dist: vantage6-client==5.0.0a29
|
|
22
|
-
Provides-Extra: dev
|
|
23
|
-
Requires-Dist: coverage==6.4.4; extra == "dev"
|
|
24
|
-
Requires-Dist: black; extra == "dev"
|
|
25
|
-
Requires-Dist: pre-commit; extra == "dev"
|
|
26
|
-
Dynamic: description
|
|
27
|
-
Dynamic: description-content-type
|
|
28
|
-
Dynamic: home-page
|
|
29
|
-
Dynamic: provides-extra
|
|
30
|
-
Dynamic: requires-dist
|
|
31
|
-
Dynamic: requires-python
|
|
32
|
-
Dynamic: summary
|
|
33
|
-
|
|
34
|
-
<h1 align="center">
|
|
35
|
-
<br>
|
|
36
|
-
<a href="https://vantage6.ai"><img src="https://github.com/IKNL/guidelines/blob/master/resources/logos/vantage6.png?raw=true" alt="vantage6" width="350"></a>
|
|
37
|
-
</h1>
|
|
38
|
-
|
|
39
|
-
<h3 align=center> A Privacy Enhancing Technology (PET) Operations platform</h3>
|
|
40
|
-
<h3 align="center">
|
|
41
|
-
|
|
42
|
-
<!-- Badges go here-->
|
|
43
|
-
|
|
44
|
-
[](https://github.com/vantage6/vantage6/actions/workflows/release.yml)
|
|
45
|
-
[](https://badge.fury.io/py/vantage6)
|
|
46
|
-
[](https://github.com/vantage6/vantage6/actions/workflows/unit_tests.yml)
|
|
47
|
-
[](https://coveralls.io/github/vantage6/vantage6?branch=main)
|
|
48
|
-
[](https://app.codacy.com/gh/vantage6/vantage6/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
|
|
49
|
-
[](https://zenodo.org/badge/latestdoi/492818831)
|
|
50
|
-
[](https://discord.gg/yAyFf6Y)
|
|
51
|
-
[](https://research-software-directory.org/software/vantage6)
|
|
52
|
-
|
|
53
|
-
</h3>
|
|
54
|
-
|
|
55
|
-
<p align="center">
|
|
56
|
-
<a href="#books-quickstart">Quickstart</a> •
|
|
57
|
-
<a href="#project-structure">Project structure</a> •
|
|
58
|
-
<a href="#gift_heart-join-the-community">Join the community</a> •
|
|
59
|
-
<a href="#scroll-license">License</a> •
|
|
60
|
-
<a href="#black_nib-code-of-conduct">Code of conduct</a> •
|
|
61
|
-
<a href="#black_nib-references">References</a>
|
|
62
|
-
</p>
|
|
63
|
-
|
|
64
|
-
---
|
|
65
|
-
|
|
66
|
-
This repository is contains all the **vantage6** infrastructure source code. The **vantage6** technology enables to manage and deploy privacy enhancing technologies like Federated Learning (FL) and Multi-Party Computation (MPC). Please visit our [website](https://vantage6.ai) to learn more!
|
|
67
|
-
|
|
68
|
-
You can find more (user) documentation at [readthedocs](https://docs.vantage6.ai). If you have any questions, suggestions or just want to chat about federated learning: join our [Discord)](https://discord.gg/yAyFf6Y) channel.
|
|
69
|
-
|
|
70
|
-
## Infrastructure overview
|
|
71
|
-
|
|
72
|
-

|
|
73
|
-
|
|
74
|
-
_A High level overview of the vantage6 infrastructure. Vantage6 has both a
|
|
75
|
-
client-server and peer-to-peer architecture. The client is used by the researcher to
|
|
76
|
-
create (PET) computation requests. It is also used to manage users, organizations and
|
|
77
|
-
collaborations. The server contains users, organizations, collaborations, tasks and
|
|
78
|
-
their results. It provides a central access point for both the clients and nodes. The
|
|
79
|
-
nodes have access to privacy sensitive data and handle computation requests retrieved
|
|
80
|
-
from the server. Computation request are executed as separate containers on the node.
|
|
81
|
-
These containers are connected to containers at other nodes by a internal network._
|
|
82
|
-
|
|
83
|
-
## :books: Quickstart
|
|
84
|
-
|
|
85
|
-
### Requirements
|
|
86
|
-
|
|
87
|
-
The **vantage6** infrastructure is delivered in Docker images. To run these images, you
|
|
88
|
-
need to have [Docker](https://docs.docker.com/get-docker/) installed. To install the
|
|
89
|
-
latest version of the vantage6 CLI, you need to have
|
|
90
|
-
[Python](https://www.python.org/downloads/), we recommend using an environment manager
|
|
91
|
-
like [mini-conda](https://docs.conda.io/en/latest/miniconda.html).
|
|
92
|
-
|
|
93
|
-
Install the latest version of the vantage6 CLI by using:
|
|
94
|
-
|
|
95
|
-
```bash
|
|
96
|
-
pip install vantage6
|
|
97
|
-
```
|
|
98
|
-
|
|
99
|
-
This install the `v6` commands, which allows you to manage your nodes and servers. To view all available options, run:
|
|
100
|
-
|
|
101
|
-
```bash
|
|
102
|
-
v6 --help
|
|
103
|
-
```
|
|
104
|
-
|
|
105
|
-
For example you can create a local test setup by using:
|
|
106
|
-
|
|
107
|
-
```bash
|
|
108
|
-
v6 dev create-demo-network
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
This creates a local network with a server and two nodes. You can start the network by running:
|
|
112
|
-
|
|
113
|
-
```bash
|
|
114
|
-
v6 dev start-demo-network
|
|
115
|
-
```
|
|
116
|
-
|
|
117
|
-
This will start the server and nodes in the background. You can view the logs by running:
|
|
118
|
-
|
|
119
|
-
```bash
|
|
120
|
-
# View node logs
|
|
121
|
-
v6 node attach
|
|
122
|
-
|
|
123
|
-
# View server logs
|
|
124
|
-
v6 server attach
|
|
125
|
-
```
|
|
126
|
-
|
|
127
|
-
From here you can use the [vantage6-client](https://pypi.org/project/vantage6-client)
|
|
128
|
-
to interact with the server. The demo network has a pre-configured organization with
|
|
129
|
-
the following credentials:
|
|
130
|
-
|
|
131
|
-
- Username: `dev_admin`
|
|
132
|
-
- Password: `password`
|
|
133
|
-
|
|
134
|
-
For example, you can create a new organization by running:
|
|
135
|
-
|
|
136
|
-
```python
|
|
137
|
-
from vantage6.client import Client
|
|
138
|
-
|
|
139
|
-
client = Client(
|
|
140
|
-
server_url='http://127.0.0.1:7601/api',
|
|
141
|
-
auth_url='http://127.0.0.1:8080',
|
|
142
|
-
log_level='debug'
|
|
143
|
-
)
|
|
144
|
-
client.authenticate()
|
|
145
|
-
client.setup_encryption(None)
|
|
146
|
-
|
|
147
|
-
client.organization.create(
|
|
148
|
-
name='My organization',
|
|
149
|
-
address1='My address',
|
|
150
|
-
address2='My address',
|
|
151
|
-
zipcode='1234AB',
|
|
152
|
-
country='The Netherlands',
|
|
153
|
-
domain='my-organization.com'
|
|
154
|
-
)
|
|
155
|
-
```
|
|
156
|
-
|
|
157
|
-
You can find more (user) documentation at [readthedocs](https://docs.vantage6.ai)
|
|
158
|
-
|
|
159
|
-
## Project structure
|
|
160
|
-
|
|
161
|
-
### PYPI packages
|
|
162
|
-
|
|
163
|
-
This repository is home to 6 PyPi packages:
|
|
164
|
-
|
|
165
|
-
- [vantage6](https://pypi.org/project/vantage6) -> _CLI for managing node and server instances_
|
|
166
|
-
- [vantage6-client](https://pypi.org/project/vantage6-client) -> _Python client for interacting with the vantage6-server_
|
|
167
|
-
- [vantage6-algorithm-tools](https://pypi.org/project/vantage6-algorithm-tools) -> _Python tools to facilitate algorithm development_
|
|
168
|
-
- [vantage6-node](https://pypi.org/project/vantage6-node) -> _Node application package_
|
|
169
|
-
- [vantage6-server](https://pypi.org/project/vantage6-server) -> _Server application package_
|
|
170
|
-
- [vantage6-algorithm-store](https://pypi.org/project/vantage6-algorithm-store) -> _Algorithm store application package_
|
|
171
|
-
- [vantage6-common](https://pypi.org/project/vantage6-common) -> _Package with common vantage6 functions_
|
|
172
|
-
- [vantage6-backend-common](https://pypi.org/project/vantage6-backend-common) -> _Package with functions common to central server and algorithm store_
|
|
173
|
-
|
|
174
|
-
**Note that when using vantage6 you do not install the _server_ and _node_ packages. These are delivered to you in Docker images.**
|
|
175
|
-
|
|
176
|
-
This repository also hosts the code for the vantage6 user interface (UI). The UI
|
|
177
|
-
is an Angular web application that can be used to interact with the vantage6 server
|
|
178
|
-
easily.
|
|
179
|
-
|
|
180
|
-
### Docker images
|
|
181
|
-
|
|
182
|
-
The vantage6 infrastructure is delivered in Docker images. All Docker images are stored
|
|
183
|
-
in our private [Harbor](https://goharbor.io/) registry. The most important images are:
|
|
184
|
-
|
|
185
|
-
- `harbor2.vantage6.ai/infrastructure/node:VERSION` -> _Node application Docker image_
|
|
186
|
-
- `harbor2.vantage6.ai/infrastructure/server:VERSION` -> _Server application Docker image_
|
|
187
|
-
- `harbor2.vantage6.ai/infrastructure/ui:VERSION` -> _User interface Docker image_
|
|
188
|
-
- `harbor2.vantage6.ai/infrastructure/algorithm-store:VERSION` -> _Algorithm store Docker image_
|
|
189
|
-
|
|
190
|
-
with `VERSION` being the full semantic version of the vantage6 infrastructure, e.g.
|
|
191
|
-
`4.0.0` or `4.1.0rc0`.
|
|
192
|
-
|
|
193
|
-
Several other images are used to support the infrastructure:
|
|
194
|
-
|
|
195
|
-
- `harbor2.vantage6.ai/infrastructure/infrastructure-base:VERSION` -> _Base image for the infrastructure_
|
|
196
|
-
- `harbor2.vantage6.ai/infrastructure/alpine` -> _Alpine image used for vpn traffic forwarding_
|
|
197
|
-
|
|
198
|
-
And finally there are some images released for algorithm development:
|
|
199
|
-
|
|
200
|
-
- `harbor2.vantage6.ai/infrastructure/algorithm-base:MAJOR.MINOR` -> _Base image for algorithm development_
|
|
201
|
-
- `harbor2.vantage6.ai/infrastructure/algorithm-ohdsi-base:MAJOR.MINOR` -> _Extended algorithm base image for OHDSI algorithm development_
|
|
202
|
-
|
|
203
|
-
## :gift_heart: Join the community!
|
|
204
|
-
|
|
205
|
-
We hope to continue developing, improving, and supporting **vantage6** with the help of
|
|
206
|
-
the federated learning community. If you are interested in contributing, first of all,
|
|
207
|
-
thank you! Second, please take a look at our
|
|
208
|
-
[contributing guidelines](https://docs.vantage6.ai/en/main/devops/contribute.html)
|
|
209
|
-
and our [code of conduct](CODE_OF_CONDUCT.md).
|
|
210
|
-
|
|
211
|
-
<a href="https://github.com/vantage6/vantage6/graphs/contributors">
|
|
212
|
-
<img src="https://contrib.rocks/image?repo=vantage6/vantage6" />
|
|
213
|
-
</a>
|
|
214
|
-
|
|
215
|
-
## :scroll: License
|
|
216
|
-
|
|
217
|
-
This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.
|
|
218
|
-
|
|
219
|
-
## :black_nib: Code of Conduct
|
|
220
|
-
|
|
221
|
-
Please note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). **By participating in any way in this project you agree to abide by its terms.**
|
|
222
|
-
|
|
223
|
-
## :black_nib: References
|
|
224
|
-
|
|
225
|
-
If you are using **vantage6**, please cite this repository as well as the accompanying papers as follows:
|
|
226
|
-
|
|
227
|
-
> - F. Martin, M. Sieswerda, H. Alradhi, et al. vantage6. Available at https://doi.org/10.5281/zenodo.7221216. Accessed on MONTH, 20XX.
|
|
228
|
-
> - A. Moncada-Torres, F. Martin, M. Sieswerda, J. van Soest, G. Gelijnse. VANTAGE6: an open source priVAcy preserviNg federaTed leArninG infrastructurE for Secure Insight eXchange. AMIA Annual Symposium Proceedings, 2020, p. 870-877. [[BibTeX](https://arturomoncadatorres.com/bibtex/moncada-torres2020vantage6.txt), [PDF](https://vantage6.ai/vantage6/)]
|
|
229
|
-
> - D. Smits\*, B. van Beusekom\*, F. Martin, L. Veen, G. Geleijnse, A. Moncada-Torres, An Improved Infrastructure for Privacy-Preserving Analysis of Patient Data, Proceedings of the International Conference of Informatics, Management, and Technology in Healthcare (ICIMTH), vol. 25, 2022, p. 144-147. [[BibTeX](https://arturomoncadatorres.com/bibtex/smits2022improved.txt), [PDF](https://ebooks.iospress.nl/volumearticle/60190)]
|
|
230
|
-
|
|
231
|
-
---
|
|
232
|
-
|
|
233
|
-
<p align="center">
|
|
234
|
-
<a href="https://vantage6.ai">vantage6.ai</a> •
|
|
235
|
-
<a href="https://discord.gg/yAyFf6Y">Discord</a> •
|
|
236
|
-
<a href="https://vantage6.discourse.group/">Discourse</a> •
|
|
237
|
-
<a href="https://docs.vantage6.ai">User documentation</a>
|
|
238
|
-
</p>
|