본문 바로가기

개발자정보

LM Studio 설치 가이드

반응형

1. 시스템 요구사항

  • 운영체제:
    • Windows 10 이상 (64-bit)
    • macOS 11 이상 (Apple Silicon 또는 Intel)
    • Linux (Ubuntu, Debian, Arch 등)
  • 메모리(RAM): 최소 8GB (16GB 이상 권장)
  • 저장공간: 모델에 따라 수 GB ~ 수십 GB 필요
  • GPU: 선택 사항 (CPU 모드도 가능, GPU 사용 시 속도 향상)

2. LM Studio 다운로드

  1. 공식 사이트 접속:
    https://lmstudio.ai
  2. 페이지 하단 또는 상단의 Download 버튼 클릭
  3. 운영체제에 맞는 설치파일 선택 후 다운로드:
    • Windows: LM_Studio_Setup.exe
    • macOS: LM_Studio.dmg
    • Linux: .AppImage 또는 .deb 파일

3. 설치 과정

🔹 Windows

  1. 다운로드한 LM_Studio_Setup.exe 파일 실행
  2. 설치 마법사의 안내에 따라 설치
  3. 설치 후 바탕화면 또는 시작 메뉴에서 LM Studio 실행

🔹 macOS

  1. LM_Studio.dmg 파일 더블 클릭
  2. LM Studio 아이콘을 Applications 폴더로 드래그
  3. 응용프로그램 폴더에서 실행 (보안 경고가 뜨면 [시스템 환경설정 → 보안 및 개인정보 보호 → 허용] 선택)

🔹 Linux

AppImage 사용 시:

chmod +x LM_Studio.AppImage
./LM_Studio.AppImage

bash

Debian/Ubuntu (.deb):

sudo dpkg -i lmstudio_<version>.deb
sudo apt-get install -f  # 의존성 해결
sudo dpkg -i lmstudio_<version>.deb sudo apt-get install -f # 의존성 해결

4. 첫 실행 및 모델 다운로드

  1. LM Studio 실행
  2. 좌측 메뉴에서 Explore 선택
  3. 원하는 LLM(예: Mistral, LLaMA, Phi, Gemma 등) 검색 및 다운로드
    • 예: mistral-7b-instruct.Q4_K_M.gguf
  4. 다운로드 후 Run 클릭으로 모델 실행

5. 로컬 서버 API 사용 (선택)

LM Studio는 OpenAI API 호환 포트를 제공합니다.

  1. Settings → API 메뉴 진입
  2. Enable OpenAI compatible API 활성화
  3. 기본 포트: http://localhost:1234/v1
  4. 원하는 앱 (예: LM Studio와 연동되는 VS Code 확장, OBSidian, Chatbot UI 등)에 해당 주소 사용

6. 자주 발생하는 문제 해결

문제해결 방법
모델 실행 시 메모리 부족 더 작은 양자화 모델(Q4, Q5 등) 선택
GPU 사용 안됨 GPU 드라이버 설치 여부 확인 (NVIDIA CUDA 등)
API 호출 오류 Settings → API 주소 확인 (localhost:1234)
 

7. 참고자료

반응형