Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs/SK-958 | Improve docs #675

Merged
merged 13 commits into from
Aug 30, 2024
Merged

Docs/SK-958 | Improve docs #675

merged 13 commits into from
Aug 30, 2024

Conversation

ahellander
Copy link
Member

@ahellander ahellander commented Aug 19, 2024

Description

This PR imroves the docs based on Salman's experiences from running the tutorial in the workshop.

  • Update Getting Started to "typical FL flow" to make it more pedagogical (start server, prepare client, start client, run training).
  • Extend "FEDn project" page with more detail and code examples.
  • Updated "Using the Python API" page
  • Gathered content related to the local development sandbox under one main section.

@ahellander ahellander requested review from sztoor and KatHellg August 19, 2024 22:06
@ahellander ahellander changed the title DOCS/SK-958 | Update headings in quickstart to align with the typical FL-flow Docs/SK-958 | Update headings in quickstart to align with the typical FL-flow Aug 19, 2024
@sztoor
Copy link
Member

sztoor commented Aug 24, 2024

I have added a few comments. I think it will be better if we take out the APIClient instructions and make a separate quick stack for API-based communication. The one mentioned in this document will not work until we talk about tokens, URLs etc. I think it will cause confusion.

Copy link
Member

@sztoor sztoor left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These changes bring clarity to the instructions.


2. Install FEDn on your client
-------------------------------
First install the FEDn API on your local machine (client):
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

API and client-side libraries.


3. Create the compute package and seed model
--------------------------------------------
**Create the compute package and seed model**

In order to train a federated model using FEDn, your Studio project needs to be initialized with a ``compute package`` and a ``seed model``. The compute package is a code bundle containing the
code used by the client to execute local training and local validation. The seed model is a first version of the global model.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We need to give them the instructions to generate compute package and seed model:

Locate into the fedn/examples/mnist-pytorch folder.

fedn package create --path client

This will create a file called package.tgz in the root of the project.

Next, create the seed model:

fedn run build --path client

This will create a file called seed.npz in the root of the project.

@ahellander ahellander changed the title Docs/SK-958 | Update headings in quickstart to align with the typical FL-flow Docs/SK-958 | Improve docs Aug 30, 2024
@ahellander ahellander merged commit 4d00645 into master Aug 30, 2024
11 checks passed
@ahellander ahellander deleted the docs/SK-958 branch August 30, 2024 11:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants