핵심 요점
- H2O.ai가 2026년 2월 26일 github.com/h2oai/h2ogpt를 아카이브 — 저장소는 읽기 전용이며, 새로운 커밋이나 풀 리퀘스트가 병합되지 않음
- Apache 2.0 라이선스, 아카이브 시점 기준 약 12,000개의 GitHub 스타와 1,300개의 포크
- PDF, Word, Excel, 이미지, 비디오 프레임, 오디오에 대한 RAG. 벡터 저장소로 Chroma, Weaviate, 또는 인메모리 FAISS 사용 가능
- 문서화된 50개 이상의 추론 백엔드: Ollama, Hugging Face TGI, vLLM, llama.cpp/GGML, ExLLaMa, 그리고 API 기반 모델을 위한 OpenAI, Azure OpenAI, Anthropic, Google, MistralAI, Groq
- 비전(LLaVa 및 API 비전 모델), 이미지 생성(Stable Diffusion 계열, Flux), 음성(Whisper 음성 인식, 음성 복제를 지원하는 텍스트 음성 변환)이 내장됨
- H2O.ai가 적극적으로 유지 관리하는 후속 제품은 h2oGPTe(Enterprise h2oGPT)이며, 지속적인 업데이트와 벤더 지원이 필요하다면 이를 검토해야 함
📍 한 문장으로
h2oGPT는 H2O.ai가 만든 Apache 2.0 라이선스의 자체 호스팅 RAG 및 문서 채팅 플랫폼으로, H2O.ai가 2026년 2월 26일 이를 아카이브(읽기 전용화)했습니다 — 여전히 작동하고 포크할 수 있지만, 더 이상 공식 업데이트를 받지 않습니다.
💬 쉽게 말하면
문서, 이미지, 오디오를 업로드하고 로컬 또는 API에 연결된 LLM을 사용해 그 내용에 대해 질문할 수 있는 비공개, 오프라인 가능 채팅 도구입니다. 다만 프로젝트 자체는 이제 적극적으로 개발되는 도구가 아니라 고정된 스냅샷입니다.
⚠️Warning: 향후 업데이트를 기대하며 오픈소스 h2oGPT 저장소를 중심으로 프로덕션 배포를 계획하지 마세요 — 이미 아카이브되었습니다. 적극적으로 유지 관리되고 지원되는 옵션이 필요하다면 h2oGPTe를 검토하세요.
h2oGPT란 무엇인가?
h2oGPT는 비공개 채팅과 문서 질의응답을 위한 H2O.ai의 오픈소스 애플리케이션입니다. 로컬 또는 API 기반 LLM에 연결하고 파일을 업로드하면, 모델의 일반적인 학습 지식이 아니라 해당 콘텐츠에 근거한 질문에 답할 수 있습니다. 프로젝트는 github.com/h2oai/h2ogpt에서 호스팅되며, H2O.ai가 아카이브하기 전 약 12,000개의 GitHub 스타를 기록했습니다.
- 문서 RAG: PDF, Word, Excel, 이미지, 비디오 프레임, YouTube 링크, 오디오, 코드, 마크다운을 검색 가능한 지식 베이스로 수집
- 벡터 저장소: Chroma, Weaviate, 또는 인메모리 FAISS 인덱스를 사용하며, 검색 품질을 높이는 시맨틱 청킹과 HYDE(Hypothetical Document Embeddings) 적용
- 모델 백엔드: Hugging Face transformers, llama.cpp/GGML, GPT4All, Ollama, vLLM, Hugging Face TGI, ExLLaMa를 통해 로컬로 연결하거나, 호스팅 API(OpenAI, Azure OpenAI, Anthropic, Google, MistralAI, Groq, Replicate, Together.ai)에 연결
- 멀티모달 기능: 비전 모델(LLaVa 및 GPT-4-Vision, Claude, Gemini-Pro-Vision 등 API 비전 모델), 이미지 생성(Stable Diffusion 계열, PlaygroundAI, Flux), 음성(Whisper 스트리밍 음성 인식, 음성 복제를 지원하는 텍스트 음성 변환)
- API 및 통합: 채팅 및 텍스트 완성, 함수/도구 호출, JSON 모드, 웹 검색 통합을 지원하는 OpenAI 호환 프록시 서버
- 멀티유저 지원: 네이티브 사용자명/비밀번호 인증과 Google OAuth, 역할 기반 접근 제어
h2oGPT는 아직 유지 관리되나요?
아닙니다. H2O.ai는 2026년 2월 26일 github.com/h2oai/h2ogpt 저장소를 아카이브했습니다. GitHub는 이를 "archived by the owner"로 표시하며 읽기 전용으로 만듭니다: main 브랜치에 새로운 커밋이 들어오지 않으며, 이슈와 풀 리퀘스트도 더 이상 적극적으로 검토·병합되지 않습니다.
아카이브 상태가 코드를 없애지는 않습니다. Apache 2.0은 누구나 무기한으로 포크·실행·수정·재배포할 수 있게 허용합니다 — 오늘도 여전히 저장소를 클론해 문서화된 그대로 실행할 수 있습니다. 달라지는 것은 H2O.ai가 이 특정 코드베이스의 버그를 더 이상 고치지 않고, 의존성을 업데이트하지 않으며, 기능을 추가하지 않는다는 점입니다.
- 여전히 가능한 것: Apache 2.0 하에서 기존 코드베이스를 클론·실행·수정하는 것 — 라이선스나 코드 자체가 만료된 것은 아님
- 중단되는 것: 이 저장소에 대한 H2O.ai 팀의 새로운 공식 커밋, 의존성 업데이트, 보안 패치, 이슈 검토
- H2O.ai가 대신 안내하는 곳: h2oGPTe(Enterprise h2oGPT). 2026년 내내 계속 릴리스를 출시한 상용 제품
- 이것이 의미하는 바: 오픈소스 h2oGPT 코드를 앞으로 H2O.ai의 지속적인 패치를 기대할 수 있는 도구가 아니라, 고정된 참조 구현으로 취급해야 함
⚠️Warning: 평가 기준에 "벤더가 적극적으로 유지 관리함"이 포함되어 있다면, h2oGPT(오픈소스 저장소)는 현재 이 기준을 충족하지 못합니다. h2oGPTe는 충족합니다.
기능: RAG, 백엔드, 멀티모달 지원
적극적으로 개발되던 당시 h2oGPT를 돋보이게 한 점은 문서 RAG, 폭넓은 추론 백엔드, 멀티모달 지원을 각 계층마다 별도의 도구 없이 하나의 코드베이스에 얼마나 많이 묶어냈는가였습니다.
- RAG 파이프라인: 파일 업로드 또는 데이터 소스 연결, 텍스트 추출 및 정제, 스캔 문서를 위한 DocTR 기반 OCR, 시맨틱 청킹, 임베딩, Chroma·Weaviate·FAISS로의 인덱싱
- 백엔드 유연성: 동일한 인터페이스에서 완전히 로컬인 모델(llama.cpp GGUF, Hugging Face 모델, 또는 Ollama로 제공되는 모델)이나 호스팅 API를 호출할 수 있어, 경우에 따라 프라이버시와 속도·모델 선택을 조율할 수 있음
- 비전 및 이미지 생성: 문서 이미지와 사진을 LLaVa나 API 비전 모델로 해석할 수 있으며, Stable Diffusion 계열이나 Flux를 통해 이미지를 생성할 수 있음
- 음성: Whisper를 통한 스트리밍 음성 인식, Microsoft SpeechT5 등 MPL2 라이선스 모델을 사용한 음성 복제 지원 텍스트 음성 변환
- 파인튜닝: 자체 데이터를 이용한 파인튜닝을 문서화하여 지원. H2O.ai는 노코드 파인튜닝 워크플로 전용의 별도 자매 프로젝트 H2O LLM Studio도 유지 관리함
- 적극적 개발 당시의 테스트와 신뢰성: 프로젝트는 1,000개가 넘는 단위 테스트와 통합 테스트와 함께 배포되었음
h2oGPT를 어떻게 직접 호스팅하나요?
아래 단계는 프로젝트 자체가 문서화한 Docker 및 pip 기반 설치 경로를 따릅니다. 저장소가 아카이브되었기 때문에 여러분은 고정된 스냅샷으로 작업하는 것입니다 — 시간이 지나 의존성이 호환성을 깨뜨려도 더 이상 공식 수정이 제공되지 않습니다.
- 1저장소를 클론합니다: git clone https://github.com/h2oai/h2ogpt.git, 이어서 cd h2ogpt. 여러분이 클론하는 것은 읽기 전용 아카이브 스냅샷이며, 적극적으로 업데이트되는 프로젝트가 아닙니다.
- 2Python 가상 환경에서 requirements.txt로 의존성을 설치하거나, 더 완전하고 사전 구성된 환경을 위해 프로젝트가 문서화한 Docker Compose 설정을 사용합니다.
- 3모델 백엔드를 선택합니다: 완전 오프라인 사용을 위해서는 h2oGPT를 로컬 추론 엔진(Ollama, 또는 llama.cpp를 통한 GGUF 모델)으로 지정하고, 오프라인 운영이 필수가 아니라면 호스팅 제공업체의 API 키를 설정합니다.
- 4프로젝트의 generate.py 진입점으로 애플리케이션을 실행하거나, Docker Compose 스택을 시작해 로컬 웹 인터페이스를 띄웁니다.
- 5웹 인터페이스를 통해 문서를 업로드해 비공개 지식 베이스를 구축하거나, 더 큰 문서 컬렉션을 위해 영구 벡터 저장소(Chroma 또는 Weaviate)를 연결합니다.
- 6프로젝트가 더 이상 보안 패치를 받지 않으므로, 개인적인 평가를 넘어서 이를 의존하기 전에 의존성 버전을 고정하고 직접 코드를 검토하세요.
h2oGPT에 GPU가 필요한가요?
h2oGPT 애플리케이션 자체에는 필요하지 않습니다. GPU는 선택한 백엔드에 따라서만 중요합니다 — GPU 가속 추론(Hugging Face transformers, GPU 상의 GGML 모델)이 훨씬 빠르지만, llama.cpp CPU 빌드나 GPT4All 같은 CPU 전용 백엔드도 지원됩니다.
h2oGPT는 완전히 오프라인으로 실행할 수 있나요?
네. h2oGPT는 외부 API 제공업체 호출 없이 로컬 추론 백엔드(llama.cpp, 로컬에서 실행되는 Hugging Face 모델, 또는 Ollama)만 사용하도록 구성할 수 있습니다 — 이는 프로젝트 본래의 프라이버시 우선 설계 목표와 일치합니다.
h2oGPT vs. h2oGPTe(엔터프라이즈)
H2O.ai는 이제 아카이브된 오픈소스 h2oGPT와 나란히 상용 제품인 h2oGPTe(Enterprise h2oGPT)를 판매합니다. 둘은 이름과 기원을 공유하지만 오늘날 평가해야 할 동일한 코드베이스는 아닙니다.
h2oGPT(오픈소스)
- 상태:
- 2026년 2월 26일 아카이브됨(읽기 전용)
- 호스팅:
- 자체 호스팅만 가능
- 비용:
- 무료(Apache 2.0)
- 적합한 대상:
- 고정된 RAG 코드베이스를 포크하거나 학습하기
h2oGPTe(엔터프라이즈)
- 상태:
- 적극적으로 개발 중, 2026년 내내 릴리스 출시
- 호스팅:
- 자체 호스팅, VPC, 또는 H2O.ai 관리형
- 비용:
- 맞춤형 — H2O.ai에 문의
- 적합한 대상:
- 지속적인 업데이트와 벤더 지원이 필요한 프로덕션 배포
지원과 로드맵이 있는 제품이 필요하다면, 오픈소스 h2oGPT 저장소가 같은 수준의 관심을 받을 것이라 가정하지 말고 h2ogpte.genai.h2o.ai에서 h2oGPTe를 직접 평가하세요.
h2oGPT는 누구에게 적합한가?
오픈소스 h2oGPT 저장소는 여전히 정당한 용도를 가지고 있습니다 — 다만 "프로덕션에 배포하고 벤더가 계속 업데이트해주기를 기대하는 것"보다는 범위가 좁습니다.
h2oGPT vs. Open WebUI, LibreChat, AnythingLLM, PrivateGPT, Dify
h2oGPT는 이 도구들 각각과 일부 기능에서 겹쳤지만, 오늘날 결정적인 차이는 유지 관리 상태입니다 — 대부분의 대안은 적극적으로 개발되고 있지만 h2oGPT는 그렇지 않습니다.
| 도구 | 인터페이스 | 라이선스 | 유지 관리 | 적합한 대상 |
|---|---|---|---|---|
| h2oGPT | 웹 채팅 + RAG UI | Apache 2.0 | 2026년 2월 아카이브됨 | 고정된 RAG 코드베이스 포크 |
| Open WebUI | 웹 채팅 UI | BSD-3 | 활성 | Ollama 기반 채팅 프런트엔드 |
| LibreChat | 웹 채팅 UI | MIT | 활성 | 멀티모델 ChatGPT 대안 |
| AnythingLLM | 데스크톱 + 웹 RAG | MIT | 활성 | 팀용 RAG 작업 공간 |
| PrivateGPT | API + 웹 UI | Apache 2.0 | 활성 | 완전 격리된 오프라인 RAG |
| Dify | 비주얼 + RAG + 에이전트 | 수정된 Apache 2.0 | 활성 | 올인원 LLMOps 플랫폼 |
라이선스와 유지 관리 상태는 변경될 수 있습니다 — 결정하기 전에 각 프로젝트의 저장소에서 다시 확인하세요.
역사와 설립자
H2O.ai는 2012년 Sri Ambati(CEO)와 Cliff Click이 설립했으며, Ambati가 이전에 공동 창업한 빅데이터 분석 회사 Platfora(이후 Workday가 인수)의 경험을 바탕으로 합니다.
H2O.ai는 2023년 5월 11일 h2oGPT와 이에 딸린 파인튜닝 프레임워크 H2O LLM Studio를 출시하며, 제3자 API로 데이터를 보내는 대신 자체 LLM을 통제하고 싶어하는 조직을 위한 도구로 두 제품을 자리매김했습니다. Sri Ambati는 출시 당시 이렇게 말했습니다: "Every company needs its own GPT. H2OGPT and H2O LLM Studio will empower all our customers and communities to make their own GPT." 그는 또한 프로젝트의 철학을 이렇게 설명했습니다: "Open source is about freedom, not just free. LLMs are far too important to be owned by a few large tech giants."
H2O.ai는 "h2oGPT: Democratizing Large Language Models"(arXiv:2306.08161)라는 학술 논문에서 프로젝트의 설계와 평가를 문서화했습니다. 저장소는 약 12,000개의 GitHub 스타와 1,300개의 포크로 성장한 뒤, H2O.ai가 2026년 2월 26일 이를 아카이브했으며, 이 시점에 회사의 개발 노력은 이미 h2oGPTe(Enterprise h2oGPT)로 눈에 띄게 이동한 상태였습니다.
h2oGPT 평가 시 흔한 실수
이런 실수들은 h2oGPT가 여전히 적극적으로 개발되고 있는 것처럼 다루거나, H2O.ai의 상용 제품과 혼동하는 데서 비롯됩니다.
자주 묻는 질문
h2oGPT는 아직 유지 관리되나요?
아닙니다. H2O.ai는 2026년 2월 26일 github.com/h2oai/h2ogpt 저장소를 아카이브(읽기 전용화)했습니다. 코드는 여전히 작동하고 Apache 2.0 하에서 포크할 수 있지만, 더 이상 공식 커밋, 패치, 이슈 검토를 받지 않습니다.
h2oGPT는 무료인가요?
네. h2oGPT는 Apache 2.0 라이선스이므로, 저장소가 지금은 아카이브되었더라도 상업적 목적을 포함해 무료로 사용·수정·재배포할 수 있습니다.
h2oGPT는 어떤 라이선스를 사용하나요?
수정되지 않은 Apache License 2.0입니다 — 상업적 사용, 수정, 재배포를 허용하는, 비교적 관대한 오픈소스 라이선스 중 하나입니다.
h2oGPT는 RAG를 지원하나요?
네. h2oGPT는 PDF, Word, Excel, 이미지, 비디오 프레임, 오디오, 코드를 검색 가능한 지식 베이스로 수집하며, Chroma, Weaviate, 또는 인메모리 FAISS 인덱스를 사용하고, 검색을 개선하는 시맨틱 청킹과 HYDE를 갖추고 있습니다.
h2oGPT에 GPU가 필요한가요?
반드시 필요한 것은 아닙니다. GPU 가속은 GPU 기반 백엔드에서 추론 속도를 높이지만, llama.cpp CPU 빌드나 GPT4All 같은 CPU 전용 옵션도 지원됩니다.
h2oGPT는 완전히 오프라인으로 실행할 수 있나요?
네, 호스팅 API 대신 로컬 추론 백엔드(llama.cpp, 로컬에서 실행되는 Hugging Face 모델, 또는 Ollama)만 사용하도록 구성한 경우입니다 — 이 오프라인 우선 설계는 프로젝트 본래의 목표였습니다.
h2oGPTe란 무엇이며 h2oGPT와 어떻게 다른가요?
h2oGPTe(Enterprise h2oGPT)는 아카이브된 오픈소스 h2oGPT와 별도로 판매·지원되는 H2O.ai의 상용 제품입니다. h2oGPTe는 2026년 내내 계속 릴리스를 출시한 반면, 오픈소스 저장소는 아카이브 이후 아무런 업데이트도 받지 못했습니다.
h2oGPT는 비전과 멀티모달 모델을 지원하나요?
네. h2oGPT는 LLaVa 및 GPT-4-Vision, Claude, Gemini-Pro-Vision 같은 API 비전 모델을 포함한 비전 모델 지원을 문서화했으며, Stable Diffusion 계열과 Flux를 통한 이미지 생성, Whisper를 통한 음성 인식과 텍스트 음성 변환도 지원합니다.
h2oGPT의 GitHub 스타 수는 얼마나 되나요?
2026년 2월 아카이브 시점 기준 github.com/h2oai/h2ogpt에서 약 12,000개의 스타와 1,300개의 포크를 기록했습니다. 아카이브된 저장소라도 새로운 스타가이저에 의해 스타 수가 계속 바뀔 수 있으므로, 최신 수치는 저장소에서 직접 확인하세요.
h2oGPT는 Open WebUI, AnythingLLM, PrivateGPT와 어떻게 다른가요?
기능 면에서 h2oGPT는 이들과 비슷한 RAG 및 멀티백엔드 영역을 다뤘으며, 일부 대안에는 없는 비전·음성·이미지 생성 같은 추가 멀티모달 기능도 갖추고 있었습니다. 오늘날 실질적인 차이는 유지 관리입니다: Open WebUI, AnythingLLM, PrivateGPT는 모두 적극적으로 개발되고 있지만, h2oGPT는 아카이브되었습니다.
