Trải nghiệm khi dùng Quivr
Quivr bản 2 khá khác với hình dung 'ứng dụng chat với tài liệu' mà nhiều người nhớ: README mô tả nó là một engine không có giao diện, chỉ có API. Bạn clone kho mã, chạy make dev để dựng Quivr và các thành phần phụ thuộc trong Docker, rồi nạp biến môi trường cho phiên Terminal bằng một lệnh để gọi API với khoá cục bộ.
Sau đó làm theo bài Quickstart trong tài liệu: tạo một collection, thêm một bài báo, tìm nó bằng từ khoá rồi bằng ý nghĩa, và tạo cảnh báo theo chủ đề. README ước lượng khoảng mười lăm phút cho toàn bộ quy trình. Nếu muốn có một giao diện web minh hoạ, make demo thêm một ứng dụng mẫu ở địa chỉ http://127.0.0.1:5183.
Chức năng nổi bật là theo dõi chủ đề: bạn lưu một cảnh báo như một biểu thức tìm kiếm hoặc một mô tả tự nhiên, Quivr ghi lại mọi tài liệu mới khớp kèm lý do, rồi ứng dụng của bạn đọc kết quả hoặc nhận webhook có chữ ký. Nghe giống việc xây hệ thống theo dõi tin tức, giám sát truyền thông hay thư viện tài liệu cho đội nhóm.
Tính năng nổi bật
Thu thập nội dung
Nhận tài liệu gửi từng cái hoặc theo lô, hoặc tự kéo từ nguồn như RSS, hộp thư Microsoft 365 và danh sách X; file như PDF được đọc bằng plugin.
Tìm kiếm từ khoá và ý nghĩa
Mỗi kết quả trỏ tới đúng đoạn, tài liệu và phiên bản gốc, nên luôn trích dẫn được.
Theo dõi chủ đề, nhận cảnh báo
Lưu cảnh báo bằng biểu thức hoặc mô tả tự nhiên; Quivr ghi tài liệu khớp và gửi webhook có chữ ký.
Giữ lịch sử phiên bản
Bản sửa đổi thành phiên bản mới, bản cũ vẫn đọc được; tài liệu bị rút lại sẽ biến khỏi tìm kiếm ngay.
Plugin thay thế được
Định dạng file, nguồn dữ liệu, mô hình nhúng, xếp hạng và luật cảnh báo đều là plugin dạng dịch vụ HTTP nhỏ, viết bằng ngôn ngữ nào cũng được.
Dành cho AI agent
Lệnh quivr mcp cho phép agent tìm trong Quivr và trích dẫn nguồn của từng đoạn.
Tận dụng Quivr vào việc gì?
Người làm truyền thông, PR, nghiên cứu thị trường
Theo dõi tin tức theo chủ đề
Kéo tin từ RSS rồi đặt cảnh báo theo từ khoá hoặc mô tả để biết khi có bài mới liên quan đến thương hiệu hay đối thủ.
Đội nội dung, pháp chế
Kho tài liệu có lịch sử phiên bản
Lưu tài liệu và các lần chỉnh sửa, tìm lại đúng đoạn ở đúng phiên bản.
Lập trình viên
Nguồn tri thức cho AI agent
Cho trợ lý AI tìm và trích dẫn nội dung từ kho qua MCP, mỗi câu trả lời có nguồn đi kèm.
Đội kỹ thuật, startup
Nền tảng cho ứng dụng giám sát nội dung
Xây ứng dụng riêng bên trên API cùng bộ plugin thay đổi được.
Cần chuẩn bị gì?
- Linux x86_64 hoặc Mac chip Apple Silicon.
- Docker với Compose v2, Go đúng phiên bản trong
go.mod, Python 3.12 kèmvenvvà công cụjq. - Lần khởi động đầu tải khoảng 1 GB.
- Biết dùng Terminal và gọi HTTP API.
Hướng dẫn cài đặt chi tiết
Cài trên Chạy thử (từ mã nguồn)
Chuẩn bị đủ các công cụ ở mục yêu cầu (Docker Compose v2, Go, Python 3.12, jq). README chỉ nêu Linux x86_64 và Mac Apple Silicon; Windows chưa được nhắc nên dùng WSL là việc bạn tự cân nhắc.
Clone kho mã và khởi động Quivr cùng các phụ thuộc trong Docker.
git clone https://github.com/The-Vibe-Company/quivr.git && cd quivr make devTrỏ phiên Terminal hiện tại tới API với khoá cục bộ.
eval "$(make -s env)"Muốn thêm ứng dụng web minh hoạ, chạy lệnh dưới rồi mở http://127.0.0.1:5183.
make demo
Cài trên Cài lên máy chủ
Để cài trên máy chủ bằng ảnh đã phát hành, không cần clone kho mã, README trỏ tới trang 'Run Quivr on one machine' trong tài liệu ở docs.quivr.thevibecompany.co.
Làm theo trang đó để tải tệp cấu hình Compose và đặt biến môi trường; vì các lệnh có thể đổi theo phiên bản, hãy sao chép từ tài liệu hiện hành.
Dùng thử lần đầu
Sau khi
make devvà nạp biến môi trường, mở bài Quickstart trong tài liệu chính thức để làm theo từng bước.Tạo một collection, thêm một bài báo vào rồi tìm bằng từ khoá.
Thử tìm theo ý nghĩa (dùng câu diễn đạt khác với bài viết) để thấy sự khác biệt giữa hai kiểu tìm kiếm.
Lưu một cảnh báo về chủ đề bạn quan tâm, thêm vài bài mới và xem Quivr ghi nhận cái nào khớp, kèm lý do.
Nếu có agent hỗ trợ MCP, thử lệnh
quivr mcpđể agent tìm trong kho và trích dẫn nguồn.
Mẹo dùng hay
- Đọc phần 'Versions and compatibility' và 'Known limits' trong tài liệu trước khi dùng thật: từ 2.0.0 API
/v0được giữ tương thích trong dòng 2.x và nâng cấp giữ nguyên dữ liệu. - Dùng
make demođể có giao diện thử nghiệm trước khi tự viết ứng dụng. - Chạy
make check(khoảng hai phút, không cần Docker) nếu bạn định đóng góp mã cho dự án.
Lưu ý và hạn chế
- Quivr bản 2 là một engine không có giao diện; người không biết lập trình sẽ khó dùng, và các bài hướng dẫn cũ về Quivr trên mạng có thể không còn đúng với phiên bản này.
- Chỉ hỗ trợ Linux x86_64 và Mac Apple Silicon theo README; chưa thấy hướng dẫn cho Windows.
- Thu thập hộp thư hay danh sách mạng xã hội cần tuân thủ điều khoản của dịch vụ và quyền riêng tư của người có nội dung đó.
Câu hỏi thường gặp
Quivr có giao diện để tôi bấm dùng không?
Không có giao diện chính thức, README nói Quivr chỉ có API. Có ứng dụng web mẫu chạy bằng make demo để thử nghiệm.
Giấy phép và chi phí thế nào?
Giấy phép MIT, miễn phí. Chi phí phát sinh nếu bạn dùng thêm mô hình nhúng hay dịch vụ AI bên ngoài qua plugin.
Tôi chỉ muốn chat với vài file PDF thì có nên dùng Quivr không?
Có lẽ không: Quivr nhắm tới nội dung đến liên tục và cần lập trình. Với nhu cầu đơn giản, các công cụ như Open WebUI hay AnythingLLM dễ dùng hơn.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/The-Vibe-Company/quivr.gitRepo tương tự nên xem
AnythingLLM
Mintplex-Labs / anything-llm
Ứng dụng AI tất-cả-trong-một: chat với tài liệu của bạn, dùng agent, chạy cục bộ hoặc nối mô hình đám mây
RAGFlow
infiniflow / ragflow
Nền tảng tự cài giúp AI trả lời dựa trên tài liệu của bạn, có trích dẫn nguồn.
Khoj
khoj-ai / khoj
Trợ lý AI cá nhân hỏi đáp trên tài liệu của bạn và cả web, tự cài được hoặc dùng bản cloud