Getting Started
시작하기: FedOps Agent Studio 설치와 Federated Task 생성
대상
FedOps 1.3을 처음 사용하는 사용자를 위한 공통 준비 가이드이다. Agent Studio 설치와 실행, 로그인 방법을 확인한 뒤 자신의 역할에 맞는 다음 가이드로 이동한다.
절차
1.준비사항
FedOps Agent Studio는 Docker 컨테이너로 실행된다. 먼저 다음 환경을 준비한다.
- macOS·Windows: Docker Desktop 설치 및 실행
- Linux: Docker Engine 또는 Docker Desktop 설치 및 실행
- Python과
pip - FedOps Web 계정
2. 예제와 테스트 데이터
처음 기능을 확인할 때는 다음 예제를 사용할 수 있다.
Federated Task 예제
- MNIST 숫자 분류
- 운동 후 소모 칼로리 예측
- WESAD 스트레스 예측
5개 Client 연합학습 테스트 데이터
예제 데이터는 기능 확인용이다. 원본 데이터는 FedOps Web에 업로드하지 않고 각 Client의 Agent Studio 로컬 데이터 폴더에 둔다.
3. FedOps Agent Studio 실행
터미널에서 FedOps Python 패키지를 최신 버전으로 설치하거나 업데이트한다.
pip install -U fedops
설치가 끝나면 Agent Studio를 실행한다.
fedops run agent-studio
실행 명령은 다음 작업을 자동으로 수행한다.
- Docker 실행 상태를 확인한다.
- 현재 장치에 맞는 최신 Agent Studio 이미지를 준비한다.
- 사용자 Workspace를 연결하고 컨테이너를 실행한다.
- Agent Studio 화면을 브라우저에서 연다.

Agent Studio 로그인 화면이 열리면 FedOps Web에서 사용하는 계정으로 로그인한다. 로그인 후 자신의 역할에 맞는 다음 가이드를 선택한다.
사용을 마친 뒤에는 다음 명령으로 종료한다.
fedops stop agent-studio
이 명령은 Agent Studio 컨테이너를 중지한다. Host에 연결된 Workspace, Task Data, Python 환경과 작업 기록은 삭제하지 않는다.
다음 단계
- 새 Federated Task를 만들려면 Create a New Task를 따른다.
- 기존 모델 프로젝트를 연결하려면 Import a Local Model을 참고한다. 이 경로는 작성 중인 초안이다.
- 다른 사용자가 공개한 Task에 참여하려면 Participant: Join & FL를 따른다.