
vLLM과 llama.cpp에서 모델을 교체할 때마다 매번 파라미터를 다시 작성해야 해서, 이를 관리하기 위한 도구(llmux, MIT)를
요약
vLLM과 llama.cpp를 사용할 때 모델별 파라미터 설정을 효율적으로 관리할 수 있는 도구인 llmux를 소개합니다. 프로필 기반의 설정 관리와 CLI 지원을 통해 모델 테스트 과정을 자동화하고 실수를 방지합니다.
핵심 포인트
- 모델별 파라미터를 프로필로 저장하여 간편하게 실행 가능
- vLLM 및 llama.cpp 엔진 지원
- 헤드리스 CLI를 통한 스크립트 및 SSH 실행 지원
- Linux, NVIDIA GPU, Docker 환경 필요
llmux 대시보드 [IMG:0] 저는 vLLM과 llama.cpp에서 많은 모델을 테스트합니다. 모델을 교체할 때마다 파라미터를 다시 편집하고, 각 모델을 고유한 방식으로 실행했다가, 종료한 뒤 다음 모델을 다시 실행해야 했습니다. 이는 지루하고 실수하기 쉬운 작업이었습니다. 그래서 이를 관리하기 위해 llmux를 만들었습니다. 사용하는 각 모델은 한 번만 작성하면 되는 프로필(profile)이 되며, 그 이후에는 목록에서 선택하기만 하면 해당 프로필이 속한 엔진에서 바로 시작됩니다. 동일한 엔진을 다른 버전으로 실행하는 것은 단순히 다른 이미지 태그(release, nightly, 또는 소스에서 직접 빌드한 이미지)에 고정된 또 다른 프로필일 뿐입니다. 저와 저희 팀은 실제 업무에 이 도구를 사용하고 있으며, 기능의 대부분은 그 과정에서 나왔습니다. 모든 동작에는 헤드리스 CLI (headless CLI) 쌍(llmux up, ps --json, logs, bench)이 있어 스크립트로 실행하거나 SSH를 통해 실행할 수 있습니다. 요구 사항: Linux, NVIDIA GPU, 그리고 Docker가 필요합니다. GPU 패스스루 (GPU passthrough)를 위해 NVIDIA Container Toolkit을 사용하므로, macOS와 AMD/ROCm은 아직 지원되지 않습니다. 설치 방법 (저장소를 클론하고, uv를 설정하며, llmux를 PATH에 추가합니다): curl -fsSL https://raw.githubusercontent.com/Bae-ChangHyun/llmux/main/install.sh | sh 또는 수동 설치: git clone https://github.com/Bae-ChangHyun/llmux.git | cd llmux uv tool install --editable . && uv tool update-shell 저장소: https://github.com/Bae-ChangHyun/llmux 문서: https://Bae-ChangHyun.github.io/llmux/ 이것은 저의 개인 프로젝트이며, MIT 라이선스를 따릅니다. 영어가 제 모국어가 아니기에, 이 게시물을 작성하는 데 LLM의 도움을 받았습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 r/LocalLLaMA의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기