핵심 요점
- Apache 2.0 라이선스 — 소스 코드(github.com/QuivrHQ/quivr, 현재 github.com/The-Vibe-Company/quivr에서 호스팅)는 자유롭게 사용, 수정, 포크 가능
- GitHub 메인 브랜치에 2025년 6월 19일 이후 커밋 없음 — 공식 종료 발표는 없지만 1년 넘게 눈에 띄는 개발이 없음
- GitHub 조직명이 QuivrHQ에서 The-Vibe-Company로 변경되었으며, 기존 QuivrHQ 링크는 자동으로 리디렉션됨
- 회사 웹사이트 quivr.com은 현재 오픈소스 RAG 라이브러리에 대한 언급 없이 무관한 AI 고객지원 에이전트 제품을 홍보
- pip install quivr-core는 여전히 작동하며 0.0.26 버전을 설치함 — 코드는 실행되지만 버그를 고치거나 풀 리퀘스트를 검토하는 사람은 없음
- 바로 쓸 수 있는 셀프 호스팅 채팅 인터페이스가 필요하다면 AnythingLLM이나 Khoj를 대신 검토할 것 — 둘 다 완전한 UI를 제공하며 이 리뷰 작성 시점 기준 활발히 커밋되고 있음
📍 한 문장으로
Quivr는 오픈소스, Apache 2.0 라이선스의 Python 라이브러리(quivr-core)로 RAG를 자체 앱에 통합하기 위한 것이며 셀프 호스팅 채팅 인터페이스가 아니고, GitHub 메인 브랜치는 2025년 6월 19일 이후 커밋이 없다.
💬 쉽게 말하면
오래된 글들은 Quivr를 설치해서 대화하는 브라우저 기반 "두 번째 뇌"로 설명하지만, 그 버전은 이제 저장소에 없다. 오늘날 배포되는 것은 자체 코드에 임포트하는 Python 패키지다.
⚠️경고: "파일과 대화하는" 셀프 호스팅 웹 앱을 찾고 있다면 현재 형태의 Quivr는 그것이 아니다 — 프런트엔드가 포함되지 않은 Python 라이브러리다.
Quivr는 아직 유지관리되나?
날짜가 명시된 종료 공지를 발표한 다른 오픈소스 AI 도구들과 달리, Quivr에는 공식적인 종료나 아카이브 발표가 없다. 하지만 관찰 가능한 증거는 같은 방향을 가리킨다: GitHub 메인 브랜치는 2025년 6월 19일 이후 커밋이 없고, 프로젝트를 운영하던 회사는 이제 무관한 제품을 홍보하고 있다.
저장소 자체는 GitHub에서 "아카이브됨"으로 표시되어 있지 않다 — 여전히 이슈와 토론을 받고 있으며, Apache 2.0 코드는 오늘날에도 완전히 설치 가능하다. 이를 공식적으로 종료된 프로젝트가 아니라 휴면 상태의 관리되지 않는 프로젝트로 취급할 것 — 이 구분은 의존에 따른 위험을 가늠하는 데 중요하다.
메인 브랜치 마지막 커밋
- 확인 내용:
- 2025년 6월 19일 — GitHub 커밋 API 기준 그 이후 없음
GitHub 조직
- 확인 내용:
- 저장소가 QuivrHQ에서 The-Vibe-Company로 이전됨; 기존 링크는 자동 리디렉션
최신 PyPI 릴리스
- 확인 내용:
- quivr-core 0.0.26, 2024년 12월 10일 게시
PyPI에 없는 최신 버전
- 확인 내용:
- core-0.0.33이 2025년 2월 4일 GitHub에서 태그되었지만 PyPI에는 게시된 적 없음
저장소 상태
- 확인 내용:
- 공식적으로 아카이브되지 않음 — 열린 이슈 35건과 토론이 여전히 활성화됨
회사의 현재 제품
- 확인 내용:
- quivr.com은 RAG 라이브러리에 대한 언급 없이 무관한 AI 고객지원 에이전트 제품을 홍보 중
📌참고: 이는 아래 각 섹션에서 기대할 수 있는 내용을 바꾼다: Apache 2.0 코드는 오늘 실행되지만, 활발히 개발 중인 제품이 아니라 활성 지원이 없는 동결된 의존성으로 취급하라.
Quivr란 무엇인가?
Quivr는 오픈소스 Python 라이브러리(Apache 2.0 라이선스, PyPI에 quivr-core로 게시)로, 코드로 자체 애플리케이션에 검색 증강 생성을 추가하기 위한 것이며 배포해서 브라우저로 여는 독립형 웹 앱이 아니다. 프로젝트는 스스로를 "두 번째 뇌"를 만드는 데 도움을 준다고 설명하지만, 그 두 번째 뇌는 임포트하는 라이브러리이지 호스팅된 제품이 아니다.
- pip install quivr-core로 설치 — 현재 저장소에는 Docker, 프런트엔드, 백엔드 서비스가 없음
- 핵심 추상화는 Brain 클래스: Brain.from_files(...)로 문서를 수집하고, brain.ask(...)로 질의함
- 프로젝트 README에 따르면 OpenAI, Anthropic, Mistral API와 직접 연동하거나 Ollama를 통해 로컬 모델 사용 가능
- PDF, TXT, Markdown을 기본으로 수집하며, 더 복잡한 문서를 위해 사용자 정의 파서나 관련 프로젝트 Megaparse로 확장 가능
- 검색 워크플로(이력 필터링, 쿼리 재작성, 검색, 생성)는 설정 화면이 아닌 YAML 파일로 구성됨
- 생성 전에 검색된 청크를 재정렬하는 선택적 재순위(reranker) 단계(문서화된 통합은 Cohere)
Quivr는 어떤 문서 형식, LLM, 벡터 저장소를 지원하나?
프로젝트 자체 문서와 저장소 설명에 따르면 Quivr는 PDF, TXT, Markdown 파일을 기본으로 받아들이고, OpenAI, Anthropic, Mistral API 또는 로컬 Ollama 모델에 연결하며, 벡터 저장을 위해 PGVector와 FAISS와 통합된다.
- 문서: PDF, TXT, Markdown을 기본 지원; 다른 형식은 직접 작성한 파서 또는 OCR이 많거나 복잡한 레이아웃을 위한 Megaparse(별도의 QuivrHQ 프로젝트)를 통해 지원
- LLM API: README에서 OpenAI, Anthropic, Mistral을 지원 제공업체로 명시
- 로컬 모델: Ollama가 지원 백엔드로 문서화되어 있어 클라우드 API 호출 없이 LLM 단계를 수행 가능
- 벡터 저장소: 저장소 설명에 PGVector와 FAISS가 명시됨; 프로젝트는 원칙적으로 벡터 저장소에 구애받지 않도록 설계되었지만 다른 저장소 연결은 직접 해야 하는 설정 작업
- 재순위(reranking): 선택적 Cohere 재순위 단계로 LLM에 전달되기 전 검색된 청크를 재정렬 가능
지금 Quivr를 어떻게 설치하고 셀프 호스팅하나?
Quivr에는 배포할 서버가 없다 — "셀프 호스팅"은 완전히 자신이 통제하는 인프라에서 자신의 스크립트, 서비스, 애플리케이션 안에서 이 Python 라이브러리를 실행한다는 뜻이다. 다음 단계는 로컬 파일에 대한 질문에 답하는 작동하는 Brain을 만든다.
- 1Python 3.10 이상을 설치한 뒤 패키지를 설치한다: pip install quivr-core.
- 2사용할 LLM 제공업체에 따라 API 키를 환경 변수로 설정한다 — OPENAI_API_KEY, ANTHROPIC_API_KEY, 또는 Mistral 키. 클라우드 LLM 호출을 아예 피하려면 Quivr를 로컬 Ollama 엔드포인트로 지정한다.
- 3자신의 파일로 Brain을 만든다: Brain.from_files(name="my_brain", file_paths=["doc1.pdf", "doc2.md"])는 프로세스 안에서 문서를 수집하고 색인한다.
- 4검색 단계(filter_history, rewrite, retrieve, generate)와 선택적 재순위, max_input_tokens·temperature 같은 LLM 설정을 정의하는 workflow_config.yaml 파일을 작성한다.
- 5RetrievalConfig.from_yaml("workflow_config.yaml")로 설정을 불러오고 brain.ask("질문", retrieval_config=retrieval_config)를 호출해 문서에 질의한다.
- 6재시작 후에도 유지되어야 한다면 인덱스를 직접 영구화한다 — PGVector나 FAISS 같은 벡터 저장소를 연결하지 않는 한, quivr-core는 스크립트가 실행되는 동안만 모든 것을 메모리에 보관한다.
Quivr를 실행하는 데 서버나 Docker가 필요한가요?
아니요. quivr-core는 스크립트나 애플리케이션에 임포트하는 Python 패키지로, pip install quivr-core가 배포 과정의 전부입니다. 브라우저 기반 채팅 인터페이스를 위한 프런트엔드, 백엔드 서비스, docker-compose 파일이 포함되어 있지 않으며, 이는 AnythingLLM이나 Khoj와의 뚜렷한 차이입니다.
Quivr는 로컬 LLM만으로 완전히 오프라인 작동이 가능한가요?
생성 단계에서는 가능합니다 — README는 로컬 모델을 위한 Ollama 지원을 문서화하고 있어 LLM 호출 자체는 사용자의 기기에 머무를 수 있습니다. 선택적 Cohere 재순위 단계는 건너뛰지 않는 한 클라우드 API 호출입니다.
Quivr는 누구에게 맞나?
활발한 유지관리가 없는 코드 우선 라이브러리라는 프로젝트의 현재 형태는 Quivr가 적합한 대상을 좁힌다. 특정 유형의 사용자에게는 합리적인 선택이지만, 셀프 호스팅 문서 채팅 앱을 찾는 대부분의 사람에게는 좋지 않은 선택이다.
Quivr와 대안 비교
아래의 각 대안은 배포 가능한 채팅 인터페이스를 제공하며 이 리뷰 작성 한 달 이내에 커밋이 있었다 — Quivr의 현재 상태와는 정반대다.
도구 | 인터페이스 | 라이선스 | 적합 대상 | 유지관리 |
|---|---|---|---|---|
| Quivr | Python 라이브러리, UI 없음 | Apache 2.0 | 자체 앱에 RAG를 통합하는 개발자 | 2025년 중반 이후 메인 브랜치 커밋 없음 |
| AnythingLLM | 완전한 채팅 UI, Docker | MIT | 바로 쓸 수 있는 셀프 호스팅 지식 어시스턴트 | 활발함 |
| Khoj | 채팅 UI + 에이전트 | AGPL-3.0 | 자동화 기능이 있는 셀프 호스팅 "두 번째 뇌" | 활발함 |
| PrivateGPT | API + 채팅 UI | Apache 2.0 | 엄격한 오프라인/에어갭 배포 | 활발함 |
지금 Quivr를 평가할 때 흔한 오해
이러한 오해는 Quivr에 대한 오래된 글 — 자체의 과거 마케팅을 포함해서 — 을 저장소가 오늘 제공하는 내용에 대한 설명인 것처럼 다루는 데서 비롯된다.
자주 묻는 질문
Quivr는 아직 유지관리되나요?
공식적인 종료 발표는 없지만, GitHub 메인 브랜치는 2025년 6월 19일 이후 커밋이 없으며, 프로젝트를 운영하던 회사(현재 The Vibe Company로 사업 중)는 이 리뷰 작성 시점 기준 quivr.com에서 무관한 AI 고객지원 에이전트 제품을 홍보하고 있습니다. 활발히 개발 중인 제품이 아니라 휴면 상태로 취급하세요.
Quivr는 셀프 호스팅 앱인가요, 라이브러리인가요?
라이브러리입니다. quivr-core는 검색 증강 생성을 위한 Brain 클래스를 중심으로 만들어진 Python 패키지(pip install quivr-core)입니다. 현재 저장소는 프런트엔드, 백엔드 서비스, docker-compose 파일을 제공하지 않습니다.
Quivr는 어떤 라이선스로 배포되나요?
저장소의 LICENSE 파일에 따르면 Apache License 2.0입니다. GitHub의 자동 라이선스 배지는 이 저장소를 "Other"로 표시하지만, LICENSE 파일 자체의 텍스트는 표준 Apache 2.0 라이선스입니다.
Quivr는 로컬 LLM을 지원하나요?
네. README는 OpenAI, Anthropic, Mistral에 대한 직접 API 지원과 함께 로컬 모델을 위한 Ollama 지원을 문서화하고 있습니다.
Quivr는 어떤 파일 형식을 수집할 수 있나요?
PDF, TXT, Markdown을 기본 지원합니다. 다른 형식은 직접 작성한 파서나, 스캔한 PDF처럼 더 복잡한 문서를 위한 관련 프로젝트 Megaparse가 필요합니다.
Quivr는 어떤 벡터 데이터베이스를 지원하나요?
저장소 설명에는 PGVector와 FAISS가 명시되어 있습니다. 프로젝트는 원칙적으로 벡터 저장소에 구애받지 않도록 설계되었지만, 대체 저장소 연결은 여전히 사용자가 직접 해야 하는 설정 작업입니다.
Quivr는 AnythingLLM이나 Khoj와 어떻게 다른가요?
AnythingLLM과 Khoj는 둘 다 배포 가능한 채팅 인터페이스를 제공하며 이 리뷰 작성 한 달 이내에 커밋이 있었습니다. Quivr는 Python 라이브러리만 제공하며, 포함된 프런트엔드가 없고 메인 브랜치에는 2025년 6월 이후 커밋이 없습니다.
지금도 Quivr를 설치할 수 있나요?
네. pip install quivr-core는 0.0.26 버전을 설치하며, 코드는 문서화된 대로 작동합니다. 다만 앞으로 버그 수정, 새로운 통합, 지원은 받을 수 없습니다.
quivr.com은 오픈소스 프로젝트와 같은 것인가요?
같은 회사가 운영합니다. 이 리뷰 작성 시점 기준 quivr.com은 AI 고객지원 에이전트 제품을 홍보하고 있으며, 오픈소스 RAG 라이브러리나 셀프 호스팅 지식 어시스턴트에 대한 언급은 없습니다.