LobeHub

오픈 소스 AI 채팅 클라이언트 연동 가이드 - 맞춤 제공자 및 로컬 지식 베이스 지원

​

1. 제품 소개

LobeHub는 오픈 소스, 크로스 플랫폼 AI 채팅 클라이언트(구 Lobe Chat)입니다. 다중 모델, 다중 모달리티, 플러그인 시스템, 로컬 지식 베이스를 지원합니다. GravitexAI를 통해 LobeHub에서 하나의 API 키로 100+ 주류 AI 모델에 접속할 수 있어, 각 제공업체별로 개별 가입 및 결제할 필요가 없습니다.

​

2. 빠른 시작

​

1단계: GravitexAI API Key 발급

1. GravitexAI 콘솔에 접속
2. 「API 키 새로 만들기」클릭 후 이름 지정·저장
3. sk-로 시작하는 키를 복사해 보관

​

2단계: LobeHub 설치

LobeHub는 세 가지 사용 방식을 제공합니다:

​

3단계: LobeHub 설정 열기

1. 왼쪽 상단의 「개인 아바타 → 앱 설정」을 클릭하여 설정 페이지로 이동
2. 왼쪽 내비게이션에서 「에이전트 → AI 제공자」를 선택
3. 오른쪽 상단의 + 버튼을 클릭하여 맞춤 제공자 추가

​

4단계: 맞춤 AI 제공자 생성

오른쪽 하단의 생성 버튼을 클릭하여 저장합니다.

​

5단계: 연결성 확인

생성이 완료되면 제공자 세부 정보 페이지로 이동합니다. 다음을 수행할 수 있습니다:

1. API Key 및 프록시 URL 입력: 설정을 다시 확인하거나 수정
2. 고급 옵션 활성화 (선택 사항):
   • 「Responses API 사양 사용」: 활성화하면 차세대 OpenAI 요청 형식 사용 (OpenAI 모델만 지원)
   • 「클라이언트 요청 모드 사용」: 브라우저가 직접 요청을 전송하여 응답 속도 향상
3. 연결성 확인: 드롭다운에서 모델을 선택하고 확인 버튼을 클릭하여 연결성을 테스트
4. 모델 목록 가져오기: 모델 목록 가져오기 버튼을 클릭하여 GravitexAI가 제공하는 전체 모델을 자동으로 가져오기

성공적으로 가져오면 「모델 목록」에 GravitexAI에서 현재 판매 중인 모든 모델이 유형별로 그룹화되어 표시됩니다: 채팅, 이미지, 비디오, 임베딩, TTS.

​

6단계: 모델 선택하고 대화 시작

채팅 인터페이스의 모델 드롭다운에서 사용할 모델을 선택하세요 (예: claude-opus-5, gpt-5.6-luna, deepseek-v4-pro)하고 대화를 시작하세요.

​

3. 100+ 모델 원스톱 접속

LobeHub는 여러 제공자의 공식 채널을 내장하고 있어 각각 API 키를 입력해야 합니다. GravitexAI에 연결하려면 하나의 맞춤 제공자를 생성하여 전체 모델을 커버할 수 있습니다:

​

4. LobeHub 주요 기능

​

플러그인 시스템

LobeHub는 풍부한 플러그인 마켓을 제공합니다 (설정 → 플러그인). 권장 플러그인:

• 웹 검색: 모델이 실시간으로 인터넷에서 최신 정보를 가져오도록 함
• 코드 인터프리터: 대화에서 Python 코드를 실행하고 데이터 시각화 수행
• 차트 생성: 자동으로 순서도, 마인드맵 생성
• 이미지 생성: gpt-image-2, gemini-3-pro-image 등 모델로 이미지 생성

​

로컬 지식 베이스 (RAG)

LobeHub는 파일을 업로드하여 로컬 벡터 데이터베이스를 구축하는 것을 지원합니다:

1. 「지식 베이스」페이지로 이동하여 새 지식 베이스 생성
2. PDF, Markdown, Word, Excel, TXT 등 파일 업로드
3. 시스템이 자동으로 슬라이싱 및 벡터화 수행
4. 대화 시 지식 베이스를 선택하면 모델이 프라이빗 자료를 기반으로 답변

​

다중 모달리티 대화

시각 이해, 이미지 인식, OCR을 위해 이미지 업로드 지원:

• 권장 시각 모델: gemini-3.6-flash, claude-opus-5, gpt-5.6-terra
• 채팅창에 이미지를 직접 드래그하면 모델이 자동으로 인식

​

에이전트 마켓 (Agent Market)

LobeHub는 풍부한 프리셋 에이전트 (번역, 글쓰기, 코딩, 인터뷰 등)를 내장하고 있습니다. 또한 다음을 수행할 수 있습니다:

• 「에이전트 마켓」에서 커뮤니티 공유 에이전트를 원클릭으로 활성화
• 맞춤 에이전트 생성: 페르소나, 프롬프트, 시작 메시지, 지식 베이스, 플러그인 정의

​

대화 관리 및 내보내기

• 다중 브랜치 대화, 메시지 편집 및 재생성
• 대화 내보내기: Markdown, PNG, JSON
• 채팅 기록 전역 검색

​

5. 고급 구성

​

네트워크 프록시 및 자체 호스팅

프록시 사용 또는 LobeHub 자체 호스팅이 필요한 경우:

1. 데스크톱: 설정 → 네트워크 → HTTP/HTTPS 프록시 구성
2. 자체 호스팅 (Docker): 환경 변수를 통해 GravitexAI 구성 주입:
   OPENAI_API_KEY=sk-your-gravitex-key
   OPENAI_PROXY_URL=https://api.gravitex.ai/v1
   CUSTOM_MODELS=gpt-5.6-terra,claude-opus-5,deepseek-v4-pro
   
3. 클라이언트 요청 모드: 활성화하면 브라우저가 API에 직접 연결 (브라우저가 GravitexAI에 접속할 수 있어야 함)

​

키보드 단축키

​

6. 모바일

LobeHub 데스크톱은 Windows / macOS / Linux를 지원합니다. 모바일에서는 브라우저를 통해 lobechat.com 웹 버전에 접속할 수 있습니다 (반응형 디자인) - 별도 앱 설치 불필요.

​

7. 문제 해결

​

8. 모범 사례

​

모델 선택 전략

작업별로 다른 모델을 사용하고, 복잡도에 따라 선택:

• 일상 채팅 / 단순 Q&A: gemini-3.1-flash-lite, claude-haiku-4-5, deepseek-v4-flash
• 복잡한 추론 / 긴 문서 분석: claude-opus-5, gpt-5.6-sol, deepseek-v4-pro
• 코딩: claude-opus-5, gpt-5.6-sol, claude-sonnet-5
• 이미지 이해: gemini-3.6-flash, claude-opus-5, gpt-5.6-terra
• 이미지 생성: gpt-image-2, gemini-3-pro-image

전체 모델 목록과 성능 비교는 모델 추천 페이지를 참조하세요.

​

컨텍스트 관리

• 사용하지 않는 이전 대화를 정기적으로 정리
• 복잡한 작업을 여러 짧은 대화로 분해
• 「대화 분기」 기능을 활용하여 다른 답변 탐색

​

보안 및 프라이버시

• 공공 장소에서 API Key를 공유하지 않기
• 키를 정기적으로 교체
• 민감한 대화는 LobeHub 자체 호스팅을 권장 - 데이터 완전 로컬 저장

​

자체 호스팅 권장 사항

• 프로덕션 환경에서는 Docker + PostgreSQL 사용 - 내장 데이터베이스 사용 금지
• Cloudflare를 역방향 프록시로 사용 권장
• 환경 변수를 통해 키를 중앙 집중식으로 관리하여 다중 인스턴스 배포 용이

​

9. 세 가지 방식 비교