호스팅 API, 계정, 로컬 Ollama 또는 llama.cpp 모델을 사용할 수 있는 VS Code용 오픈소스 AI 코딩 에이전트입니다.
av/harbor
Docker Compose 기반 CLI와 데스크톱 앱으로, Ollama나 llama.cpp 같은 백엔드부터 Open WebUI 같은 프런트엔드까지 미리 연결된 로컬 LLM 스택을 명령 하나로 실행합니다.
- 스타
- 3,262
- 포크
- 233
- 열린 이슈
- 52
- 마지막 커밋
- 6일 전
어떤 프로젝트인가요?
Harbor는 로컬 LLM 스택 전체를 실행할 수 있는 CLI이자 데스크톱 앱입니다. Ollama, llama.cpp, vLLM 같은 추론 백엔드, Open WebUI 같은 프런트엔드, 웹 검색용 SearXNG와 음성 채팅용 Speaches 같은 보조 서비스 중 원하는 서비스를 선택하면 Harbor가 Docker Compose 오케스트레이션과 설정, 서비스 간 연결을 처리합니다.
이 프로젝트는 UI, 백엔드, 보조 도구로 분류된 폭넓은 서비스를 지원합니다. 이미지 생성용 ComfyUI, 워크플로용 n8n과 Dify, MetaMCP 및 mcpo 같은 MCP 관련 도구가 포함됩니다. macOS에서는 Docker Model Runner, MLX, oMLX 같은 일부 백엔드가 컨테이너 내부가 아니라 호스트에서 Metal 가속을 사용해 추론을 실행합니다.
Harbor에는 Codex, Claude, OpenCode 같은 코딩 및 에이전트 CLI를 Harbor 백엔드에 연결하는 `harbor launch` 명령도 포함되어 있습니다. 이와 함께 Boost 워크플로, config 프로필, 원격 접속용 내장 터널, 설정을 독립형 Docker Compose 파일로 내보내는 eject 명령을 제공합니다.
핵심 기능
- 01`harbor up` 명령 하나로 미리 연결된 추론 백엔드와 프런트엔드를 실행합니다.
- 02SearXNG 웹 검색이나 Speaches 음성 채팅 같은 보조 서비스를 Open WebUI에 자동으로 연결합니다.
- 03macOS에서 Docker Model Runner, MLX, oMLX의 추론을 Metal 가속을 사용해 호스트에서 직접 실행합니다.
- 04수동으로 provider 설정을 하지 않고도 코딩 및 에이전트 CLI를 Harbor 백엔드에 연결해 실행합니다.
- 05config 프로필과 명령 기록을 저장하고 전환합니다.
- 06현재 설정을 독립형 Docker Compose 파일로 내보냅니다.
활용 사례
- 개인 컴퓨터에 Open WebUI와 llama.cpp 또는 Ollama 환경을 한 번에 구성하기.
- 서비스를 직접 연결하지 않고도 웹 검색 기반 RAG나 음성 채팅을 로컬 모델에 추가하기.
- 같은 프런트엔드에서 여러 추론 백엔드를 나란히 비교하기.
- 테스트를 마친 로컬 설정을 독립형 Docker Compose 배포 환경으로 옮기기.
빠른 시작
- 1
설치 가이드에 따라 Harbor CLI와 App을 설치합니다
- 2
구성이 완료된 Open WebUI 및 llama.cpp 스택을 시작합니다
harbor up - 3
Open WebUI에 SearXNG 웹 검색과 Speaches 음성 채팅을 추가합니다
harbor up searxng speaches
사용 전 알아둘 점
- 스택이 Docker Compose에서 실행되므로 Docker가 필요합니다.
- 로컬 모델을 원활하게 실행하려면 GPU와 같은 적절한 하드웨어가 필요하며, 여러 서비스로 구성된 전체 스택은 리소스를 많이 사용할 수 있습니다.
포함된 컬렉션
토픽
자주 묻는 질문
- harbor은(는) 무엇인가요?
- Docker Compose 기반 CLI와 데스크톱 앱으로, Ollama나 llama.cpp 같은 백엔드부터 Open WebUI 같은 프런트엔드까지 미리 연결된 로컬 LLM 스택을 명령 하나로 실행합니다. Harbor는 로컬 LLM 스택 전체를 실행할 수 있는 CLI이자 데스크톱 앱입니다. Ollama, llama.cpp, vLLM 같은 추론 백엔드, Open WebUI 같은 프런트엔드, 웹 검색용 SearXNG와 음성 채팅용 Speaches 같은 보조 서비스 중 원하는 서비스를 선택하면 Harbor가 Docker Compose 오케스트레이션과 설정, 서비스 간 연결을 처리합니다.
- harbor은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- harbor은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- harbor은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. harbor의 마지막 커밋은 2026년 10월 31일입니다.
- harbor은(는) 어디에 사용할 수 있나요?
- 개인 컴퓨터에 Open WebUI와 llama.cpp 또는 Ollama 환경을 한 번에 구성하기. 서비스를 직접 연결하지 않고도 웹 검색 기반 RAG나 음성 채팅을 로컬 모델에 추가하기. 같은 프런트엔드에서 여러 추론 백엔드를 나란히 비교하기. 테스트를 마친 로컬 설정을 독립형 Docker Compose 배포 환경으로 옮기기.
- harbor는 어떻게 설치하나요?
- 설치 가이드에 따라 Harbor CLI와 App을 설치합니다 구성이 완료된 Open WebUI 및 llama.cpp 스택을 시작합니다: harbor up Open WebUI에 SearXNG 웹 검색과 Speaches 음성 채팅을 추가합니다: harbor up searxng speaches
- harbor은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/av/harbor
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
내 컴퓨터에서 24시간 실행되며, 없는 도구를 자동으로 만들고 MCP를 통해 Claude Code 등과 공유하는 셀프 호스팅 Go AI 에이전트입니다.
Ollama, vLLM 또는 llama-cpp-python을 통해 소비자용 하드웨어에서 OpenAI 호환 API를 제공하는 소규모 로컬 LLM 실행 가이드 겸 챗봇 웹 앱입니다.
로컬 및 클라우드 LLM을 실행하고 대화할 수 있는 셀프 호스팅 웹 UI로, 여러 백엔드와 이미지·음악 생성, 프롬프트 라우팅을 지원합니다.
llama.cpp 기반으로 로컬 LLM을 실행하고, 로컬 API 서버와 내장 WebUI를 제공하는 macOS 메뉴 막대 앱
Rust와 iced GUI 툴킷으로 만든 로컬 AI 채팅 앱으로, llama.cpp와 Hugging Face를 통해 모델을 실행합니다.