Vane: công cụ tìm kiếm AI tự host, có nguồn trích dẫn — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về ItzCrazyKns/Vane — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: Vane: công cụ trả lời bằng AI tự host, có dẫn nguồn — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
Vane là một «answering engine» mã nguồn mở: bạn hỏi, nó tìm trên mạng qua SearxNG rồi nhờ mô hình AI tổng hợp thành câu trả lời có dẫn nguồn. Bạn tự chạy nó trên máy mình, có thể dùng model cục bộ qua Ollama hoặc model đám mây như OpenAI, Claude, Groq. Cài bằng Docker chỉ cần một lệnh, khá dễ cho người mới.
Vane là một công cụ tìm kiếm trả lời bằng AI (README gọi là «answering engine») mà bạn tự chạy trên máy của mình. Bạn gõ câu hỏi, Vane tìm thông tin trên internet, nhờ mô hình ngôn ngữ đọc và tổng hợp, rồi trả về câu trả lời kèm nguồn trích dẫn để bạn kiểm tra lại. Nếu bạn từng dùng kiểu tìm kiếm của Perplexity thì Vane cùng hướng đó, nhưng là bản mã nguồn mở, giấy phép MIT.
Ai nên dùng? Người muốn tra cứu nhanh mà vẫn thấy nguồn, người làm văn phòng hay phải đọc nhiều tài liệu, dân kinh doanh cần tìm thông tin thị trường, và lập trình viên mới muốn có một công cụ tìm kiếm AI riêng để thử nghiệm. Repo hiện có khoảng 38.194 sao và 4.295 fork trên GitHub, và vẫn được cập nhật trong vài tháng gần đây.
Điểm đáng giá nhất là sự linh hoạt: README nói Vane chạy hoàn toàn trên phần cứng của bạn, dùng được model cục bộ qua Ollama, hoặc nối với OpenAI, Claude, Gemini, Groq… Phần tìm kiếm web do SearxNG đảm nhiệm, và bản Docker đã gói sẵn SearxNG nên bạn không phải cài thêm gì.
ItzCrazyKns/Vane
Vane là công cụ tìm kiếm trả lời bằng AI, chạy trên máy bạn, dùng được model cục bộ (Ollama) hoặc đám mây, câu trả lời có dẫn nguồn.
I.Vane làm được gì
Dưới đây là những tính năng chính, giải thích theo lợi ích thực tế.
A.Hỏi và nhận câu trả lời có nguồn
Mỗi câu trả lời đi kèm nguồn trích dẫn. Lợi ích rất rõ: bạn không phải tin mù quáng vào AI, mà bấm vào nguồn để xác minh trước khi dùng thông tin vào báo cáo hay quyết định kinh doanh.
B.Dùng nhiều nhà cung cấp AI
Vane hỗ trợ model cục bộ qua Ollama và các dịch vụ đám mây như OpenAI, Anthropic Claude, Google Gemini, Groq… Bạn có thể trộn các model tùy nhu cầu. Muốn riêng tư thì chọn model chạy trên máy; muốn câu trả lời mạnh hơn thì chọn model đám mây.
C.Ba chế độ tìm kiếm
Speed Mode cho câu trả lời nhanh, Balanced Mode cho tìm kiếm hằng ngày, Quality Mode cho nghiên cứu sâu. Bạn đổi chế độ tùy việc: tra giá một món hàng thì chọn nhanh, tìm hiểu một ngành thì chọn chất lượng.
D.Chọn nguồn tìm kiếm
Bạn có thể tìm trên web, các thảo luận, hoặc bài báo học thuật. README nói thêm nguồn và tích hợp đang được phát triển.
E.Widget
Khi cần, Vane hiện các thẻ giao diện nhỏ như thời tiết, phép tính, giá cổ phiếu và một số tra cứu nhanh khác. Bạn khỏi phải đọc cả đoạn văn chỉ để biết một con số.
F.Tìm ảnh, video và tải tệp lên
Vane tìm được cả hình ảnh và video. Bạn cũng tải được tài liệu lên (PDF, tệp văn bản, ảnh) rồi hỏi về nội dung của chúng.
G.Giới hạn theo trang web, gợi ý, khám phá, lịch sử
Bạn có thể giới hạn tìm kiếm trong những website cụ thể, hữu ích khi tra tài liệu kỹ thuật. Vane gợi ý câu tìm kiếm khi bạn gõ. Mục Discover cho xem bài viết và nội dung nổi bật. Mọi lượt tìm được lưu cục bộ để bạn xem lại.
H.API cho lập trình viên
Vane có API để tích hợp vào ứng dụng riêng. README trỏ tới tài liệu API tìm kiếm nằm trong thư mục docs của repo.
II.Cần chuẩn bị gì
Theo README, có hai cách cài: dùng Docker (khuyến nghị) và không dùng Docker.
- Cách Docker: cần cài sẵn Docker và để nó đang chạy. Với cách này README cho biết ảnh Docker đã gồm cả Vane lẫn SearxNG, không cần cài thêm.
- Cách không Docker: bạn phải tự cài SearXNG, bật định dạng
JSONtrong cài đặt SearXNG và bật công cụ tìm kiếm Wolfram Alpha. README dùngnpmđể cài và chạy. README không ghi rõ phiên bản Node.js cần dùng; nếu cần biết chính xác, xem tệppackage.jsonvà thư mụcdocs/installationtrong repo. - Một mô hình AI: hoặc model cục bộ qua Ollama, hoặc API key của nhà cung cấp đám mây. Bạn nhập chúng ngay trên màn hình thiết lập của Vane, không phải sửa tệp cấu hình.
- Phần cứng, hệ điều hành: README không nêu yêu cầu cụ thể về GPU hay RAM. Nếu bạn chạy model cục bộ, cấu hình cần thiết phụ thuộc vào model bạn chọn, README không nói cụ thể.
API key của OpenAI, Claude, Groq… là bí mật của bạn và dùng dịch vụ đám mây có thể tốn phí theo mức dùng. Đừng chia sẻ key, và đừng đưa Vane ra Internet công khai khi chưa có bảo vệ: README ghi tính năng đăng nhập (authentication) vẫn nằm trong danh sách «sắp có».
III.Cài đặt từng bước
- Cài DockerCài và bật Docker trên máy của bạn
- Chạy một lệnh docker runKéo ảnh Vane về và khởi động, đã gồm sẵn SearxNG
- Mở trình duyệtVào địa chỉ localhost cổng 3000
- Thiết lậpĐiền API key hoặc địa chỉ Ollama và chọn model ở màn hình setup
- Bắt đầu hỏiGõ câu hỏi đầu tiên và xem nguồn trích dẫn
A.Cài Docker
Bạn cần Docker đã cài và đang chạy. Trên Windows hay Mac, hãy mở ứng dụng Docker Desktop trước, chờ nó báo sẵn sàng rồi mới chạy lệnh. Trang cài Docker không nằm trong README, bạn tìm trên trang chính thức của Docker.
B.Chạy Vane bằng một lệnh
Mở terminal (PowerShell trên Windows, Terminal trên Mac/Linux) rồi dán lệnh sau:
docker run -d -p 3000:3000 -v vane-data:/home/vane/data --name vane itzcrazykns1337/vane:latestLệnh này làm ba việc. -d cho container chạy nền. -p 3000:3000 đưa cổng 3000 của container ra máy bạn. -v vane-data:/home/vane/data tạo ổ lưu trữ để dữ liệu của bạn không mất khi khởi động lại. Lần đầu có thể mất một lúc vì phải tải ảnh về.
C.Mở Vane và thiết lập
Mở trình duyệt, vào http://localhost:3000. README nói bạn cấu hình API key, model… ngay trên màn hình thiết lập đầu tiên. Nếu dùng Ollama, hãy xem phần lỗi thường gặp bên dưới để điền đúng địa chỉ.
D.Tuỳ chọn: dùng SearxNG có sẵn của bạn
Nếu bạn đã có một SearxNG đang chạy, dùng bản slim:
docker run -d -p 3000:3000 -e SEARXNG_API_URL=http://your-searxng-url:8080 -v vane-data:/home/vane/data --name vane itzcrazykns1337/vane:slim-latestThay http://your-searxng-url:8080 bằng địa chỉ SearxNG thật của bạn. README nhấn mạnh SearxNG đó phải bật định dạng JSON và bật công cụ Wolfram Alpha. Sau đó vẫn vào http://localhost:3000 để cấu hình nhà cung cấp AI.
E.Tuỳ chọn: tự build từ mã nguồn bằng Docker
Cần Docker đang chạy. Tải mã nguồn về:
git clone https://github.com/ItzCrazyKns/Vane.gitSau đó vào thư mục dự án (lệnh cd Vane) rồi build và chạy:
docker build -t vane .
docker run -d -p 3000:3000 -v vane-data:/home/vane/data --name vane vaneLệnh đầu tạo ảnh Docker tên vane từ thư mục hiện tại (dấu chấm ở cuối nghĩa là «thư mục này», nên bạn phải đứng đúng trong thư mục dự án). Lệnh thứ hai chạy nó. Xong thì vào http://localhost:3000.
F.Tuỳ chọn: cài không dùng Docker
Cách này phức tạp hơn, README cũng khuyên dùng Docker. Trước hết bạn phải tự cài SearXNG, bật JSON và Wolfram Alpha. README không hướng dẫn chi tiết việc cài SearXNG, bạn xem tài liệu của SearXNG. Sau đó:
git clone https://github.com/ItzCrazyKns/Vane.git
cd VaneCài các thư viện phụ thuộc:
npm iBuild ứng dụng:
npm run buildChạy ứng dụng:
npm run startCuối cùng vào http://localhost:3000 để thiết lập API key, model và địa chỉ SearxNG. Lưu ý các lệnh npm phải chạy trong thư mục Vane vừa clone, nếu không sẽ báo không thấy package.json.
Về cập nhật phiên bản và các chi tiết khác, README trỏ tới thư mục docs/installation trong repo.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra đơn giản nhất là mở http://localhost:3000 trong trình duyệt. Nếu thấy giao diện Vane, hoặc màn hình thiết lập lần đầu, nghĩa là ứng dụng đã chạy. Với Docker, bạn cũng có thể chạy docker ps để xem container tên vane có đang hoạt động không.
Sau khi điền xong thiết lập, hãy thử một câu hỏi đơn giản, ví dụ tra thời tiết hoặc một tin tức bạn biết rõ. Kết quả mong đợi là một câu trả lời kèm các nguồn trích dẫn. Nếu Vane báo bạn chưa cấu hình nhà cung cấp model, xem phần lỗi thường gặp bên dưới.
V.Dùng vào việc thật
Dưới đây là các tình huống mình thấy hợp với khả năng Vane đã nêu trong README.
A.Chủ shop tra cứu thị trường
Bạn bán đồ gia dụng online và muốn biết xu hướng sản phẩm. Hãy chọn nguồn web và chế độ Balanced, rồi hỏi bằng tiếng Việt, ví dụ: «So sánh ưu nhược điểm của nồi chiên không dầu dung tích lớn và nhỏ cho gia đình 4 người». Bạn nhận một đoạn tổng hợp kèm nguồn. Hãy bấm vào nguồn để kiểm tra trước khi dùng trong mô tả sản phẩm.
Hỏi một câu, nhận câu trả lời kèm nguồn để tự kiểm tra, còn dữ liệu tìm kiếm nằm trên máy của chính bạn.
Ông T
B.Nhân viên văn phòng hỏi trên tài liệu
Bạn có một tệp PDF dài và cần nắm ý chính trước cuộc họp. Tải tệp lên Vane rồi hỏi: «Tóm tắt các điều khoản về thời hạn thanh toán trong tài liệu này». README nói Vane hiểu PDF, tệp văn bản và ảnh. Kết quả là phần trả lời bám theo nội dung bạn tải lên. Với tài liệu quan trọng, vẫn nên đọc lại bản gốc ở những chỗ then chốt.
C.Lập trình viên tra tài liệu kỹ thuật
Bạn đang học một framework mới và chỉ muốn tìm trong trang tài liệu chính thức. Dùng tính năng giới hạn tìm kiếm theo trang web cụ thể, rồi hỏi: «Cách cấu hình routing trong framework này». Chọn chế độ Speed khi cần đáp án nhanh, chuyển sang Quality khi vấn đề phức tạp. Kết quả là câu trả lời lấy từ đúng nguồn bạn chọn, ít bị lẫn các bài không liên quan.
D.Biến Vane thành ô tìm kiếm của trình duyệt
Nếu muốn dùng Vane thay Google hoặc Bing, README hướng dẫn: mở cài đặt trình duyệt, vào mục Search Engines (công cụ tìm kiếm), thêm một công cụ tìm kiếm mới với địa chỉ:
http://localhost:3000/?q=%sNếu Vane không chạy trên máy bạn, thay localhost bằng địa chỉ IP hoặc tên miền, và đổi cổng nếu cần. Từ đó, gõ vào thanh địa chỉ là ra kết quả của Vane.
VI.Lỗi hay gặp và cách xử lý
A.Vane báo chưa cấu hình nhà cung cấp model
Theo README, nếu bạn dùng một máy chủ model cục bộ tương thích OpenAI, hãy kiểm tra ba điều. Một: máy chủ đang chạy ở 0.0.0.0 (không phải 127.0.0.1) và đúng cổng bạn điền trong API URL. Hai: tên model bạn điền đúng với model đang nạp trên máy chủ. Ba: đã điền API key; nếu máy chủ không đòi key thì vẫn nên gõ một giá trị nào đó, đừng để trống.
B.Không kết nối được Ollama
Đây là lỗi hay gặp nhất khi Vane chạy trong Docker còn Ollama chạy ngoài. Hãy kiểm tra địa chỉ API của Ollama trong phần cài đặt. README hướng dẫn: trên Windows và Mac dùng http://host.docker.internal:11434; trên Linux dùng địa chỉ máy của bạn với cổng 11434 (đoạn địa chỉ này bị mất trong bản README mình có, bạn xem lại README gốc). Đổi số cổng nếu bạn dùng cổng khác.
C.Ollama trên Linux vẫn không nối được
Theo README, bạn cần cho Ollama lắng nghe trên mạng: trong tệp /etc/systemd/system/ollama.service thêm dòng Environment="OLLAMA_HOST=0.0.0.0:11434", rồi chạy systemctl daemon-reload và systemctl restart ollama. Đồng thời kiểm tra tường lửa không chặn cổng 11434. Vì đây là sửa cấu hình hệ thống, hãy chỉnh cẩn thận và xem thêm tài liệu của Ollama mà README dẫn tới.
D.Lỗi kết nối Lemonade
Nếu bạn dùng Lemonade, cách xử lý tương tự: kiểm tra API URL trong phần cài đặt, Windows và Mac dùng http://host.docker.internal:8000, và bảo đảm máy chủ Lemonade đang chạy, nhận kết nối từ mọi giao diện (0.0.0.0) và cổng 8000 không bị tường lửa chặn.
E.Tìm kiếm không ra kết quả khi dùng SearxNG riêng
Với bản slim hoặc cách không Docker, README nhấn mạnh SearxNG phải bật định dạng JSON và bật công cụ Wolfram Alpha. Nếu bạn quên một trong hai, Vane có thể không lấy được kết quả. Hãy kiểm tra lại cài đặt SearxNG và địa chỉ bạn điền vào SEARXNG_API_URL.
VII.Có nên dùng không
Điểm mạnh. Cài bằng một lệnh Docker, đã gồm sẵn SearxNG. Câu trả lời có dẫn nguồn. Bạn chọn được model cục bộ hoặc đám mây, nhiều chế độ tìm kiếm, có tải tệp, tìm ảnh, video, API và lưu lịch sử trên máy mình. Giấy phép MIT, dự án đông người dùng và còn được cập nhật.
Giới hạn. Chất lượng câu trả lời phụ thuộc vào model bạn chọn và kết quả SearxNG. README chưa nêu yêu cầu phần cứng cho model cục bộ. Tính năng đăng nhập vẫn nằm trong danh sách sắp có, nên không nên mở Vane ra Internet cho nhiều người dùng chung khi chưa có lớp bảo vệ riêng. Dùng model đám mây thì câu hỏi của bạn vẫn đi qua nhà cung cấp đó, và có thể phát sinh phí.
Khi nào chọn cách khác. Nếu bạn chỉ thỉnh thoảng cần tra cứu và không muốn quản lý Docker hay API key, một dịch vụ tìm kiếm AI có sẵn trên web sẽ đỡ công hơn. Còn nếu bạn muốn một công cụ tìm kiếm AI tự chủ, có nguồn, đổi model dễ dàng và thử nghiệm thoải mái, Vane là lựa chọn đáng cài thử.
Câu hỏi thường gặp
Vane có miễn phí không?
Bản thân Vane là mã nguồn mở với giấy phép MIT, nên dùng miễn phí. Tuy vậy, nếu bạn nối với dịch vụ AI đám mây như OpenAI, Claude hay Groq thì có thể phát sinh phí theo bảng giá của họ. README không nêu chi phí cụ thể.
Vane có cần GPU không?
README không nêu yêu cầu GPU. Nếu bạn dùng model đám mây thì máy bạn chỉ cần chạy được Docker. Nếu muốn chạy model cục bộ qua Ollama, cấu hình cần thiết tùy model bạn chọn, README chưa có thông tin cụ thể.
Vane chạy được trên Windows không?
README có hướng dẫn riêng cho Windows khi nối với Ollama (dùng địa chỉ host.docker.internal), nên có thể chạy bằng Docker trên Windows. README không liệt kê yêu cầu phiên bản hệ điều hành cụ thể.
Dữ liệu tìm kiếm của tôi có riêng tư không?
README mô tả Vane là công cụ ưu tiên quyền riêng tư, chạy trên phần cứng của bạn, và lịch sử tìm kiếm được lưu cục bộ. Tuy nhiên nếu bạn chọn model đám mây thì nội dung câu hỏi vẫn được gửi cho nhà cung cấp đó. Muốn kín nhất thì dùng model cục bộ qua Ollama.
Vane khác gì Google hay các công cụ tìm kiếm thông thường?
Vane không chỉ liệt kê liên kết mà nhờ mô hình AI tổng hợp thành câu trả lời kèm nguồn trích dẫn. Phần tìm kiếm web do SearxNG đảm nhiệm. README cũng hướng dẫn thêm Vane vào thanh tìm kiếm của trình duyệt như một công cụ tìm kiếm thay thế.
Tôi dùng được model nào với Vane?
README nêu model cục bộ qua Ollama và các nhà cung cấp OpenAI, Anthropic Claude, Google Gemini, Groq, ngoài ra có nhắc tới Lemonade và máy chủ cục bộ tương thích OpenAI. Bạn chọn và nhập thông tin ở màn hình thiết lập của Vane.
Vane có API để tích hợp vào ứng dụng của tôi không?
Có. README cho biết Vane có API để chạy tìm kiếm, dùng nhiều model và nhận câu trả lời. Tài liệu chi tiết nằm trong thư mục docs của repo, ở mục API.


