3. 준비하기

📍 지금 어디: 공통 기초 3/3 — ① 연합학습과 FedOps → ② 데이터와 모델 → ③ 준비하기 → 다음: 내 역할의 트랙

🎯 이 단계에서 하는 일: 내 PC 에 Agent Studio 를 띄우고, Studio 와 FedOps Console 에 로그인하고, 실습 템플릿을 받습니다. Owner 와 Client 모두 해야 합니다. 학습은 서버가 아니라 각자의 PC(Studio)에서 일어나기 때문입니다.

  1. 1) 사양 확인
  2. 2) Docker Desktop 설치
  3. 3) Agent Studio 실행
  4. 4) 계정과 로그인
  5. 5) 실습 템플릿 받기
  6. ✅ 체크리스트
  7. 다음 단계

1) 사양 확인

python3 --version    # 3.10 ~ 3.12 이어야 함
  • 메모리 16 GB 권장 (Studio 컨테이너 + CPU LLM 이 함께 동작. LLM 은 모델 활용 트랙에서만 씀)
  • 디스크 20 GB 이상 여유
  • 인터넷 연결 필요 (Docker 이미지·패키지·LLM 다운로드)

2) Docker Desktop 설치

Docker Desktop 을 설치하고 실행해 둡니다. Linux 는 Docker Engine + compose 플러그인이면 됩니다.

docker version --format '{{.Server.Version}}'
docker compose version

최신 Docker 를 쓰세요. Docker 20.10 같은 오래된 버전에서는 이미 떠 있는 Studio 를 fedops 명령이 멈추지 못합니다(unknown flag: --timeout).

3) Agent Studio 실행

python3 -m venv ~/.venvs/fedops && source ~/.venvs/fedops/bin/activate
pip install -U fedops
fedops run agent-studio

브라우저에 Studio(http://localhost:24368)가 열리면 성공입니다. 처음에는 Docker 이미지를 받느라 몇 분 걸립니다.

Intel Mac 에서 pip install -U fedops 가 llvmlite 빌드 오류로 실패하면 pip install --no-deps fedops 로 설치하세요.

끝낼 때는 fedops stop agent-studio 입니다. Studio 는 ~/fedops-workspace/ 아래에 코드와 로컬 데이터를 둡니다. 이 폴더는 지우지 마세요.

왜 Studio 는 내 PC 에서 도나요? 연합학습에서 데이터는 내 PC 를 떠나지 않아야 합니다. 그래서 학습·점검·참여는 전부 내 PC 의 Studio 에서 하고, 웹(Console)에서는 데이터가 필요 없는 일(공개·승인·서버 운영)만 합니다.

4) 계정과 로그인

계정은 FedOps Console 로그인 화면의 Create account 에서 만듭니다. 하나의 FedOps 계정으로 Console 과 Studio 에 모두 로그인합니다.

하려는 것필요한 계정
한 역할만1개
혼자서 두 역할 연습 (Owner 가 자기 Task 에 참여)1개
Owner 와 Client 를 나눠서 (참여 요청·승인까지 경험) — 이 튜토리얼의 기준2개 — Owner 용, Client 용

로그인은 두 곳에 따로 합니다.

  1. Agent Studio 첫 화면에서 FedOps server 가 Main FedOps 인지 확인하고 FedOps 계정으로 로그인
  2. 브라우저에서 FedOps Console 에도 로그인 — FedOps Web(https://ccl.gachon.ac.kr/fedops) 오른쪽 위 Open Console, 또는 https://ccl.gachon.ac.kr/fedops/console

⚙️ FedOps server — 어느 FedOps 서버에 접속할지, 곧 연합학습 집계를 어디서 할지 정합니다. 온프렘·AWS·Kakao Cloud 등 다른 서버는 Add server 에 그 서버 주소를 넣어 추가합니다. 계정·Task 는 서버마다 따로라서, 이 튜토리얼은 Main FedOps 그대로 둡니다.

Studio 와 Console 은 로그인이 공유되지 않습니다. 두 계정을 쓸 때는 Studio 와 Console 이 같은 계정인지 늘 확인하세요. 다르면 “내 Task 가 안 보인다”는 문제가 납니다.

5) 실습 템플릿 받기

git clone https://github.com/gachon-CCLab/FedOps-hands-on-guide.git
cd FedOps-hands-on-guide/template

이후 명령은 모두 이 template/ 폴더를 기준으로 합니다. git 이 없으면 GitHub 페이지의 Code → Download ZIP 으로 받아 풀어도 됩니다.

역할템플릿에서 쓰는 것
Owner거의 전부 — 병원별 데이터 만들기, 일반 학습 코드, Federated Task 코드, Agent 규칙, 앱 코드
Clientdata/ 만 — 클리블랜드 병원 데이터(cleveland/dataset.csv)를 만드는 데 씀. 코드는 Owner 가 게시한 것을 Studio 가 내려받습니다. 실제 상황이라면 Client 는 자기 기관 데이터를 갖고 있으므로 템플릿이 필요 없습니다

✅ 체크리스트

  • docker compose version 이 버전을 출력한다
  • http://localhost:24368 에 Agent Studio 가 열린다
  • Studio 의 FedOps server 가 Main FedOps 다
  • Studio 와 Console 에 같은 계정으로 로그인됐다
  • template/ 폴더가 로컬에 있다

다음 단계


Back to top

© 2026 Cognitive Computing Lab, Gachon University