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를 사용하라
- 별도의 채팅 앱을 배포하는 대신 RAG 파이프라인을 자신의 애플리케이션 코드에 직접 연결하려는 Python 개발자인 경우
- 이미 프로젝트에서 quivr-core를 사용 중이며 새 기능이 아니라 계속 작동하기만 하면 되는 경우
- 추가 서비스를 세우지 않고 가볍고 스크립트로 다룰 수 있는 RAG 레이어를 원하는 경우
- 2025년 중반 이후 커밋이 없고 향후 유지관리자가 확정되지 않은 라이브러리에 의존하는 것을 받아들일 수 있는 경우
이럴 때 Quivr를 피하라
- 브라우저에서 바로 쓸 수 있는 "문서와 대화하기" 인터페이스를 원하는 경우 — 현재 형태의 Quivr는 프런트엔드를 전혀 제공하지 않음
- 앞으로 활발한 버그 수정, 새로운 LLM 통합, 또는 벤더 지원이 필요한 경우
- 컴플라이언스나 벤더 리스크 검토에서 최근 유지관리 활동의 증거가 필요한 경우
- 파일 업로드 기능이 있는 클라우드 채팅 어시스턴트의 셀프 호스팅 대안을 기대했던 경우 — AnythingLLM이나 Khoj를 대신 검토할 것
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에 대한 오래된 글 — 자체의 과거 마케팅을 포함해서 — 을 저장소가 오늘 제공하는 내용에 대한 설명인 것처럼 다루는 데서 비롯된다.
오해 1: Quivr가 여전히 셀프 호스팅 채팅 앱이라고 가정하기
인터넷에 있는 많은 Quivr 소개, 오래된 비교 글을 포함해, 브라우저 프런트엔드와 Supabase 기반 API를 갖춘 전체 스택 버전을 설명한다. 그 버전은 오늘날 저장소가 제공하는 것이 아니다 — Python 라이브러리만 남아 있다.
오해 2: GitHub 스타 수를 활발한 유지관리와 혼동하기
Quivr는 여러 해에 걸친 역사 동안 많은 스타를 모았다. 스타는 과거의 인기를 측정할 뿐 현재의 커밋 활동을 나타내지 않는다 — 스타 배지로 프로젝트 상태를 추측하기보다 이 리뷰처럼 커밋 이력을 직접 확인하라.
오해 3: pip가 최신 태그 버전을 설치할 것이라 기대하기
pip install quivr-core는 0.0.26 버전을 설치한다. GitHub에는 더 새로운 core-0.0.33 태그가 있지만 PyPI에는 게시된 적이 없다 — 따라서 GitHub 저장소에서 직접 설치하면 pip 패키지와 다른 버전을 얻게 된다.
자주 묻는 질문
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 라이브러리나 셀프 호스팅 지식 어시스턴트에 대한 언급은 없습니다.
