Import a Local Model
Local Project를 Federated Task로 전환
대상
기존 Python/PyTorch 모델 프로젝트와 데이터를 보유한 Task Owner를 위한 가이드이다. 기존 구현을 FedOps 계약에 연결하고, 로컬 실행을 검증한 뒤 Federated Task로 게시하는 과정을 다룬다.
사전 조건
- Getting Started에 따라 Agent Studio를 실행하고, Web과 Studio에 동일한 계정으로 로그인한다.
- 가져올 프로젝트의 모델 코드, 데이터 구조와 필요한 라이브러리를 확인한다.
- 프로젝트 원본을 보관하고, 수정할 프로젝트 폴더를 정한다.
핵심 원칙
Local Project를 Studio에서 여는 작업과 Web에 Federated Task를 생성하는 작업은 구분한다. 코드·데이터·실행 환경을 준비한 뒤, 로컬 프로젝트가 의도한 Web Task에 연결되어 있는지 확인하고 게시한다.
Local Project 준비 → FedOps 계약 연결·검증
→ Web Draft 생성 또는 연결 → Release Candidate 제출 → Owner Publish
절차
1. Local Project 열기
Agent Studio 좌측 메뉴의 Workspace에 들어간다.

우측 상단 New Federated Task를 클릭한다

Start local Project 시작 동작을 선택한다.

- 기존 프로젝트를 원래 위치에서 열거나, 명시적으로 Studio Workspace에 import한다.
- import를 선택한 경우 원본과 Studio copy 중 어느 쪽이 source of truth인지 결정한다.
같은 프로젝트를 여러 번 복사해 서로 다른 source가 생기지 않게 한다.
2. FedOps 계약 적용
기존 코드를 모두 Baseline에 맞춰 다시 작성하지 않는다. 다음 adapter 경계를 연결한다.
- model 생성과 model state load/save
- local dataset loader와 preprocessing
- train/evaluate callback
- Tool AI input/output manifest와 predict hook
- requirements와 Python version
FedOps 관리 entrypoint의 이름과 signature는 바꾸지 않는다.
3. Local Data와 실행 확인
- 기존 데이터 위치를 Task Data에 연결하거나 필요한 데이터만 배치한다.
- Python Environment를 sync한다.
- Local Train으로 Initiative Model을 export한다.
- Release Readiness와 Participation Readiness를 각각 확인한다.
Release Readiness는 공개 가능한 Task인지, Participation Readiness는 실제 참여 장치에서 local update를 만들 수 있는지를 검사한다.
4. Web identity 연결
다음 중 하나를 선택한다.
- 새 Federated Task Draft를 만들고 현재
localProjectId와 연결 - 이미 만든 Web Draft의
taskId와 연결
연결 결과는 localProjectId ↔ taskId 하나여야 하며 local path를 Web에 저장하지 않는다.
5. Release와 Publish
- Task Card용
README.md를 참여자 관점으로 작성한다. - Release Candidate를 제출한다.
- Web에서 Owner Publish한다.
- Registry에서 Published Release, snapshot과 model checksum을 확인한다. 원본 데이터가 Release에 포함되지 않았는지도 확인한다.
주의 사항
- 폴더 이름이나 로컬 경로를
taskId대신 사용하지 않는다. - 프로젝트를 Studio에서 열었다는 사실만으로 Web Draft 생성이나 연결이 완료되었다고 판단하지 않는다. 연결된 Task를 별도로 확인한다.
- 원본과 Studio 복사본을 함께 사용할 경우 실제로 수정하고 실행하는 폴더를 구분한다.
- 기존 모델 파일을 Initiative Model로 사용하려면 파라미터 구조와 모델 manifest의 호환성 검증을 먼저 통과해야 한다.
다음 단계
게시한 Task의 참여자와 집계 서버를 운영하려면 Campaign & Server Management을 참고한다.