sammcj/gollama

Gollama – Ollama 모델을 관리하는 터미널 UI

무엇인가요 – Gollama는 로컬 Ollama API와 통신하는 작고 간단한 Go 프로그램(맥OS / 리눅스)으로, 설치된 모델을 보여주고, 실행하고, 편집하고, 복사하고, 삭제하고, 푸시하며, 기타 다양한 작업을 수행할 수 있게 해줍니다. 텍스트 기반 사용자 인터페이스(TUI)에서 작동하며, 키보드 단축키만으로 완전히 탐색 가능하며, 스크립트 실행 가능한 즉각적인 작업을 위한 몇 가지 명령줄 플래그도 제공합니다.

왜 중요한가요 – Ollama는 로컬에서 LLM을 제공하는 인기 있는 방법이지만, 그 명령줄 도구는 기본적인 ollama pull/run 등에 국한되어 있습니다. Gollama는 더 풍부하고 인터랙티브한 계층을 추가합니다: 모델을 크기, 양자화 수준, 패밀리, 수정 일자 등으로 정렬하고 필터링할 수 있으며, 상세한 메타데이터를 확인할 수 있고, 선호하는 에디터에서 모델의 Modelfile을 직접 편집할 수 있으며, 특정 양자화 수준과 컨텍스트 길이에 대한 VRAM 요구량을 추정할 수 있고, 레지스트리에 모델을 푸시할 수 있습니다. 모든 작업을 터미널에서 벗어나지 않고 수행할 수 있습니다.

주요 기능 (문서에 기록된 대로)

이름, 크기, 양자화 수준, 패밀리, 수정 일자 등의 열을 포함한 모델 목록
어떤 열이든 정렬 및 필터링 가능
핫키 액션: Space (선택), Enter (실행), i (검사), D (삭제), e (편집), c (복사/이름 변경), U (모두 언로드), p/ctrl+p (다운로드), P (푸시), t (실행 중인 모델 표시) 등
UI에서 직접 모델의 Modelfile 편집 가능 (설정 또는 $EDITOR에 지정된 에디터 사용)
VRAM 추정기능: 다양한 양자화 수준과 컨텍스트 길이에 대한 메모리 사용량 표를 출력하고, 주어진 메모리 예산에 가장 적합한 양자화 수준을 제안할 수 있음
간단한 CLI 단축키 (gollama -l로 목록 표시, -e <model>로 편집, -s <term>로 검색, --vram …로 메모리 분석)
JSON 설정 파일 (~/.config/gollama/config.json)로 기본 정렬, 표시 열, API 엔드포인트, 로그 레벨, 테마, 에디터, 모델 실행용 선택적 Docker 컨테이너 설정 가능
테마 지원 (dark-neon, light-neon, 또는 사용자 정의 JSON 테마)
설정 가능한 레벨로 ~/.config/gollama/gollama.log에 로깅

설치 – README는 Go 툴체인 사용을 권장합니다:

go install github.com/sammcj/gollama/v2@latest

또는 설치 스크립트를 curl로 다운로드하거나, 릴리스 페이지에서 미리 빌드된 바이너리를 다운로드하여 $PATH에 배치할 수 있습니다.

일반적인 사용법 – 설치 후 gollama를 실행하세요 (또는 g로 별칭 설정). TUI가 열리고 모델 목록이 표시됩니다. 위에 나열된 키 바인딩을 사용하여 모델을 관리하세요. 빠른 단일 명령어로 사용하려면 플래그를 사용할 수 있습니다. 예시:

gollama -l                     # UI 없이 모델 목록 보기

gollama -e my-model               # 모델의 Modelfile 편집

gollama --vram llama3.1:8b-instruct-q6_K   # VRAM 추정 표 보기

설정 – 샘플 config.json이 제공됩니다. 주목할 만한 필드:

default_sort / sort_order – 목록의 초기 정렬 방식
columns – 표시할 열
ollama_api_url – 일반적으로 http://localhost:11434
editor – 외부 에디터 경로 (VS Code도 작동함)
theme – 테마 JSON 파일 이름
docker_container – Ollama를 Docker 컨테이너 내에서 실행하는 실험적 지원

상태 – 프로젝트는 여전히 활발히 개발 중입니다 (README에 따르면, v2.0.1은 2025년 12월에 출시됨). 저자는 LM Studio 통합이 제거되었으며, 다른 프로젝트에 집중하면서 개발 속도가 느려졌다고 언급하고 있습니다.

라이선스 – 리포지토리는 표준 오픈소스 라이선스를 포함하고 있습니다 (개요에서는 정확한 SPDX 식별자는 표시되지 않았지만, License 섹션에 명시되어 있음).

위의 모든 세부 정보는 리포지토리의 README에서 직접 인용된 것이며, 추가 기능은 추측되지 않았습니다.

sammcj/gollama

Gollama – Ollama 모델을 관리하는 터미널 UI

관련