tryonlabs/opentryon

Open-source APIs, SDKs, and models for building virtual try-on and fashion AI applications. Generate models, edit garments, create photoshoots, and build personalized fashion experiences.

OpenTryOn (opentryon) – 빠른 개요

정의 – 패션 중심의 AI 모델과 서비스를 대규모로 번들링한 오픈소스 Python 툴킷입니다. 개발자는 통합 명령줄 인터페이스(CLI), Python 라이브러리 또는 TryOn Studio라는 웹 UI를 통해 가상 피팅, 이미지/비디오 생성, 멀티모달 이해, 배경 제거 및 관련 전처리를 로컬 또는 클라우드 API를 통해 실행할 수 있습니다.

핵심 기능

영역	기능	예시 모델 (저장소에 나열된 모델)
가상 피팅 (VTO)	인물 이미지에 의류 합성, 제품 착용 모델 생성, 의상 재구성, 이미지-비디오 변환.	`flux-vto`, `google-vertex-vto`, `outfitanyone-plus`, `photoroom`, `fashn-tryon-max`, `klein-4b` (상업적 사용 가능), `catvton`
이미지 생성 / 편집	텍스트-이미지 변환, 스타일 전이, 업스케일링, 구성.	`nano-banana-pro`, `flux2-pro`, `gpt-image-2.5`, `ideogram-4.0`, `pruna-p-image`, `qwen-image`
멀티모달 이해	이미지/비디오 설명, 의상 메타데이터 추출, 패션 콘텐츠 관련 질문 답변.	`claude-haiku-5.5`, `kimi-k3`, `qwen3.8-max`, `nemotron‑omni`, `hy4-preview`
비디오 생성	텍스트나 이미지를 짧은 패션 비디오로 변환, 의상 애니메이션화.	`veo-3.1`, `luma-ray-2`, `seedance-2.5`, `ltx-2.5`, `runway‑gen‑4.5`, `nvidia‑cosmos‑3`
배경 제거 및 전처리	사진에서 의류나 인물을 깔끔하게 분리, 학습 데이터 준비.	`ben2`
안전 및 의사결정 도구	피팅 요청의 안전성 분류, 예/아니오 결정.	`tryon-safety-classifier`, `jev`, `d1-3b`
임베딩 (Embeddings)	검색 또는 하위 모델을 위한 멀티모달 특징 벡터 생성.	`embeddinggemma-2`, `pplx-embed-v2`

사용 방법

CLI – 한 줄 명령 예시:

opentryon vton --model flux-vto \
  --person-image data/model-1.jpg \
  --garment-image data/garment.png

MCP 서버 – FastMCP 서버를 시작하여 Claude, Cursor 또는 TryOn Studio UI와 같은 에이전트가 각 모델을 도구로 사용할 수 있게 합니다.
TryOn Studio – MCP 서버를 내부적으로 호출하는 Next.js 웹 인터페이스로, VTO, 생성, 이해 등을 클릭 한 번으로 경험할 수 있습니다.

Python 라이브러리 – 어댑터를 직접 가져오기:

from tryon.api import KimiUnderstandAdapter
adapter = KimiUnderstandAdapter(model="kimi-k3")
result = adapter.understand_image("data/model-1.jpg", prompt="Describe this outfit.")
print(result["text"])

설치 스냅샷

# 클론 및 conda 환경 설정 (권장)
git clone https://github.com/tryonlabs/opentryon.git
cd opentryon
conda env create -f environment.yml
conda activate opentryon
pip install -e .               # 핵심 패키지
pip install -e "[local]"      # 선택적 로컬/GPU 모델
cp env.template .env          # 필요한 API 키 입력 (예: BFL, Moonshot)

또는 간단히:

pip install opentryon

프로젝트 레이아웃 (상위 수준)

tryon/ – 핵심 패키지 (API 래퍼, CLI, 모델 레지스트리, 에이전트, 데이터셋, 전처리).
tryondiffusion/ – 확산 모델 기반 피팅 연구 코드.
mcp-server/ – FastMCP 서버 구현.
demo/ – Gradio 데모 스크립트.
notebooks/ – Jupyter 예제.
docs/ – Docusaurus 사이트 (전체 문서, 튜토리얼, 로드맵).
openapi/ & postman/ – 외부 미디어 API용 Swagger / Postman 컬렉션.

문서 및 커뮤니티

전체 문서 – https://tryonlabs.github.io/opentryon/ (설치, CLI 가이드, MCP 설정, 에이전트 사용법, 모델별 페이지).
Discord – 지원 및 기능 요청을 위한 커뮤니티 채팅.
로드맵 – ROADMAP.md에 공개.
라이선스 – Creative Commons BY‑NC 4.0 (비상업적 사용, 저작자 표시 필요).

누가 사용할까요?

패션 이커머스 플랫폼: 처음부터 모든 것을 구축하지 않고 가상 피팅 기능을 추가하려는 경우.
개발자 및 연구원: 의류 관련 확산 모델이나 멀티모달 모델을 실험하려는 경우.
제품 팀: 내부 도구(카탈로그 생성, 의상 설명, 배경 제거 등)를 구축하는 경우.
AI 에이전트: MCP를 통해 패션 인식 도구를 노출해야 하는 경우.

결론

OpenTryOn은 수십 개의 최첨단 패션 관련 AI 모델을 단일하고 사용하기 쉬운 인터페이스 뒤에 통합하는 포괄적이고 확장 가능한 툴킷입니다. 클라우드 API 호출과 로컬 GPU 추론을 모두 지원하여 패션 기술 분야의 빠른 프로토타이핑 및 프로덕션급 배포에 적합합니다.