Skip to main content
OpenAI 호환 API 기반 고성능 LLM 서빙 환경입니다.

문서 기준

  • 기준일: 2026-02-23
  • Python: 3.12
  • 운영체제: macOS, Ubuntu, Windows
  • 동기화 명령: uv sync

호환성 메모

vLLM 0.15.1은 PyTorch 2.10을 아직 지원하지 않습니다. Ubuntu x86_64에서는 PyTorch 2.9.1로 고정하고, macOS/Windows에서는 클라이언트 개발 용도로 최신 PyTorch를 사용합니다.

pyproject.toml

설치

1

프로젝트 생성

2

의존성 락 및 동기화

3

Jupyter 커널 등록

설치 확인

모든 OS 공통 확인:
Ubuntu x86_64 추가 확인:

서빙 시작 (Ubuntu x86_64)

기본 서빙

주요 서빙 옵션

클라이언트 호출 예시

트러블슈팅

설치 점검 목록

  • 관리자 권한/필수 도구 등 사전 요구사항을 먼저 확인했습니다.
  • 설치 후 버전 확인 명령어(--version)를 실행해 정상 설치를 검증했습니다.
  • PATH/환경변수 변경이 필요한 경우 터미널을 다시 열어 적용 여부를 확인했습니다.
  • 문제가 생겼을 때를 대비해 설치 로그 또는 스크린샷을 남겼습니다.

관련 문서

Setup 홈

운영체제별 설치 흐름을 다시 확인합니다.