Argilla 퀵스타트 — 배포부터 SDK 연결까지

Argilla 퀵스타트

Argilla는 무료·오픈소스·자체 호스팅 도구라서 먼저 UI를 배포해야 해요. 배포 방법은 크게 둘 중 하나를 골라요. 가장 쉽게 시작하는 길은 Hugging Face Hub에 배포하는 거예요.

출처: https://docs.argilla.io/latest/getting_started/quickstart/

Hugging Face Hub에 배포

추천 방식이에요. 5분 안에 준비되고 서버를 유지하거나 명령어를 실행할 필요가 없어요. Hub의 Argilla Space 템플릿으로 새 Space를 만들면 돼요.

코드로 배포하려면 먼저 패키지를 설치하고:

pip install argilla

Argilla.deploy_on_spaces 메서드로 Space를 만들 수 있어요. 이 메서드는 <your-username>-argilla.hf.space 형태의 URL로 Space를 만들고, argilla 워크스페이스와 소유자를 만들고, 인증된 Argilla 클라이언트까지 반환해요.

import argilla as rg

authenticated_client = rg.Argilla.deploy_on_spaces(api_key="<api_key>")

첫 데이터셋 만들기

UI의 홈페이지에서 "Import dataset from Hugging Face"를 클릭하고 stanfordnlp/imdb 같은 repo id를 붙여넣어요. Argilla가 데이터셋의 열을 해석해 Fields(피드백을 받을 텍스트·챗 등)와 Questions(라벨·평점·랭킹 등)로 매핑해요. 데이터셋 이름과 워크스페이스, split을 정하면 백그라운드에서 임포트가 시작돼요.

큰 데이터셋은 첫 10k 행만 임포트되므로, 나머지는 Python SDK의 코드 스니펫으로 이어서 임포트해요.

SDK 설치·연결

노트북에서 SDK를 설치하고:

! pip install argilla

API 키와 URL로 클라이언트를 만들어요. API 키는 Argilla Space의 My Settings, URL은 브라우저 주소(*.hf.space)에서 확인해요.

import argilla as rg

client = rg.Argilla(
    api_url="<api_url>",
    api_key="<api_key>",
)

Argilla 퀵스타트 — 배포부터 SDK 연결까지