Vane: công cụ trả lời bằng AI có dẫn nguồn, chạy trên máy bạ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 công cụ tìm kiếm trả lời bằng AI (answering engine) mã nguồn mở, giấy phép MIT. Nó kết hợp tìm kiếm web qua SearxNG với mô hình AI chạy cục bộ (Ollama) hoặc đám mây (OpenAI, Claude, Groq...) và dẫn nguồn cho câu trả lời. Cài bằng Docker chỉ cần một lệnh, rồi điền key và chọn model ngay trên giao diện web.
Vane là một công cụ tìm kiếm trả lời bằng AI, mã nguồn mở, chạy trên chính máy của bạn. Bạn gõ câu hỏi, Vane đi tìm trên web, rồi nhờ một mô hình AI tổng hợp thành câu trả lời có kèm nguồn trích dẫn. Cách làm này gần giống Perplexity, nhưng bạn tự giữ quyền kiểm soát.
Repo này hợp với ba nhóm người. Thứ nhất là người làm văn phòng, kinh doanh hay phải tra cứu nhiều và muốn có câu trả lời kèm link để kiểm chứng. Thứ hai là người quan tâm riêng tư, không muốn lịch sử tìm kiếm nằm ở máy chủ của người khác. Thứ ba là lập trình viên muốn một công cụ có API để gắn vào ứng dụng của mình.
Điểm đáng giá nhất là bạn được chọn mô hình AI: chạy cục bộ bằng Ollama, hoặc dùng OpenAI, Claude, Groq... Cài bằng Docker chỉ một lệnh, bản đóng gói sẵn đã có công cụ tìm kiếm SearxNG đi kèm. Hiện repo có khoảng 38.188 sao và 4.294 fork, vẫn được cập nhật trong vài tháng gần đây.
ItzCrazyKns/Vane
Vane là công cụ tìm kiếm và trả lời bằng AI mã nguồn mở, tự chạy trên máy bạn, dùng SearxNG để tìm web và dẫn nguồn cho từng câu trả lời.
I.Vane làm được gì
Dưới đây là các tính năng chính, kèm lợi ích thực tế khi dùng.
- Dùng nhiều nhà cung cấp AI. Vane hỗ trợ Ollama (chạy cục bộ), OpenAI, Anthropic Claude, Google Gemini, Groq và một số nơi khác. Bạn có thể phối hợp các model tuỳ nhu cầu, ví dụ model rẻ cho việc nhanh, model mạnh cho việc khó.
- 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 tự cân giữa tốc độ và độ kỹ.
- Chọn nguồn tìm. Có thể tìm trên web, trong các thảo luận hoặc bài báo học thuật. Muốn tra tài liệu chuyên môn thì chọn nguồn học thuật cho đỡ nhiễu.
- Widget. Khi câu hỏi phù hợp, Vane hiện thẻ gọn như thời tiết, phép tính, giá cổ phiếu. Tra nhanh khỏi phải đọc cả đoạn văn.
- Tìm web bằng SearxNG. SearxNG gom kết quả từ nhiều công cụ tìm kiếm mà không lộ danh tính của bạn. README nói hỗ trợ Tavily và Exa đang được phát triển, chưa phải tính năng có sẵn.
- Tìm ảnh và video. Kết quả không chỉ có chữ.
- Tải tệp lên để hỏi. Bạn có thể tải PDF, tệp văn bản, ảnh lên và đặt câu hỏi về nội dung.
- Giới hạn theo trang web. Biết trước nên tra ở trang nào (tài liệu kỹ thuật, trang nghiên cứu) thì khoanh vùng luôn.
- Gợi ý khi gõ. Vane gợi ý câu tìm kiếm để bạn đặt câu hỏi tốt hơn.
- Discover. Mục để xem bài viết, nội dung đang được quan tâm trong ngày mà không cần tìm.
- Lịch sử tìm kiếm. Mỗi lần tìm đều được lưu cục bộ để xem lại sau.
II.Cần chuẩn bị gì
Theo README, có hai cách cài: dùng Docker (khuyên dùng) và không dùng Docker. Phần chuẩn bị tuỳ cách bạn chọn.
- Cách dùng Docker: máy đã cài Docker và Docker đang chạy. README không nêu yêu cầu hệ điều hành cụ thể, chỉ có hướng dẫn riêng cho Windows, Mac, Linux ở phần kết nối Ollama.
- Cách không dùng Docker: tự cài SearXNG, bật định dạng JSON trong cài đặt SearXNG và bật công cụ tìm kiếm Wolfram Alpha. Sau đó dùng npm để cài và chạy. README không ghi phiên bản Node.js cần dùng. Bạn xem thêm trong thư mục docs/installation của repo.
- Một mô hình AI: hoặc API key của nhà cung cấp đám mây (OpenAI, Claude, Groq...), hoặc Ollama chạy sẵn trên máy. Key và model được điền ngay trong màn hình thiết lập của Vane, không cần sửa file.
- Phần cứng: README không nêu yêu cầu cấu hình hay GPU. Nếu bạn dùng model cục bộ qua Ollama thì độ nặng phụ thuộc vào model bạn chọn, README không nói cụ thể.
Nếu dùng model đám mây, mỗi câu hỏi sẽ gọi API của nhà cung cấp đó và có thể phát sinh chi phí theo bảng giá của họ. Hãy giữ kín API key, đừng chia sẻ ảnh chụp màn hình có lộ key.
III.Cài đặt từng bước
Cách nhanh nhất là Docker bản đầy đủ. Tóm tắt các bước:
- Cài và bật DockerĐảm bảo Docker đang chạy trên máy
- Chạy lệnh docker runKéo và khởi động Vane cùng SearxNG đi kèm
- Mở trình duyệtVào http://localhost:3000
- Thiết lậpĐiền API key hoặc địa chỉ Ollama, chọn model trong màn hình setup
A.Mở terminal và chạy Vane bằng Docker
Trên Windows, bạn mở PowerShell hoặc Terminal; trên Mac/Linux mở Terminal. Không cần vào thư mục nào cả. Dán lệnh sau rồi nhấn Enter:
docker run -d -p 3000:3000 -v vane-data:/home/vane/data --name vane itzcrazykns1337/vane:latestLệnh này làm các việc sau. -d cho chạy ngầm. -p 3000:3000 mở cổng 3000 để bạn vào bằng trình duyệt. -v vane-data:/home/vane/data tạo ổ lưu trữ để dữ liệu và tệp tải lên không mất khi khởi động lại. --name vane đặt tên cho container. Ảnh này đã gồm cả Vane lẫn SearxNG nên không cần cài thêm gì.
Chỗ người mới hay vấp: nếu Docker chưa bật, lệnh sẽ báo lỗi kết nối. Hãy mở Docker Desktop và đợi nó chạy xong rồi thử lại.
B.Mở Vane và thiết lập
Mở trình duyệt, vào địa chỉ http://localhost:3000. Bạn sẽ thấy màn hình thiết lập. Ở đó bạn điền API key, chọn model và các tuỳ chọn khác. README nói toàn bộ việc này làm trực tiếp trên giao diện.
C.Nếu bạn đã có SearxNG riêng
Nếu đã có sẵn một máy SearxNG, bạn dùng bản slim (nhẹ, không kèm SearxNG):
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-latestHãy thay http://your-searxng-url:8080 bằng địa chỉ SearxNG thật của bạn. SearxNG đó phải bật định dạng JSON và bật công cụ Wolfram Alpha. Sau đó vào http://localhost:3000 để cấu hình model như bình thường.
D.Cách khác: tự build từ mã nguồn bằng Docker
Cách này dành cho người muốn tuỳ chỉnh. Đảm bảo Docker đang chạy, rồi tải mã nguồn về:
git clone https://github.com/ItzCrazyKns/Vane.git
cd VaneSau đó build và chạy:
docker build -t vane .
docker run -d -p 3000:3000 -v vane-data:/home/vane/data --name vane vaneLệnh docker build tạo ảnh Docker từ mã nguồn trong thư mục hiện tại (dấu chấm ở cuối là thư mục hiện tại), nên bạn phải đứng đúng trong thư mục Vane. Xong thì vào http://localhost:3000.
E.Cách không dùng Docker
README khuyên dùng Docker vì đơn giản hơn. Nếu vẫn muốn không dùng Docker, bạn cần cài SearXNG trước (bật JSON, bật Wolfram Alpha), rồi:
git clone https://github.com/ItzCrazyKns/Vane.git
cd Vane
npm i
npm run build
npm run startnpm i cài thư viện, npm run build biên dịch ứng dụng, npm run start khởi động. Xong, mở http://localhost:3000 và điền cả địa chỉ SearxNG trong màn hình thiết lập. Nếu cần cập nhật phiên bản, README chỉ bạn xem tài liệu trong thư mục docs/installation của repo.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra đơn giản theo README: mở http://localhost:3000. Nếu thấy màn hình thiết lập của Vane thì ứng dụng đã chạy. Điền key hoặc địa chỉ Ollama, chọn model, rồi thử hỏi một câu quen thuộc như thời tiết hôm nay ở thành phố bạn ở.
Nếu Vane trả lời và có kèm các nguồn tham khảo bên dưới, nghĩa là cả phần tìm kiếm lẫn phần AI đều hoạt động. Nếu Vane báo chưa cấu hình nhà cung cấp mô hình, bạn 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à vài tình huống bám đúng các tính năng có trong README.
A.Chủ shop tra cứu thị trường, đối thủ
Bạn bán đồ gia dụng online và muốn biết xu hướng sản phẩm mới. Chọn chế độ Balanced, nguồn là web, rồi hỏi bằng ngôn ngữ thường ngày, ví dụ: So sánh ưu nhược điểm của nồi chiên không dầu loại lớn và loại nhỏ cho gia đình 4 người. Bạn nhận được câu trả lời tổng hợp kèm link nguồn, bấm vào từng nguồn để kiểm tra trước khi đưa vào bài mô tả sản phẩm.
B.Nhân viên văn phòng hỏi trực tiếp trên tài liệu
Bạn có một tệp PDF báo cáo dài và cần nắm ý chính. Tải tệp lên Vane rồi hỏi: Tóm tắt các rủi ro chính được nêu trong tài liệu này. Bạn nhận lại tóm tắt dựa trên nội dung tệp, đỡ phải đọc từng trang. Nhớ rằng độ chính xác còn phụ thuộc model bạn chọn, nên những số liệu quan trọng vẫn nên đối chiếu lại bản gốc.
Một công cụ trả lời có dẫn nguồn và chạy trên máy mình giúp mình tin câu trả lời hơn, vì luôn kiểm tra lại được.
Ông T
C.Lập trình viên tra tài liệu kỹ thuật
Bạn đang đọc một thư viện mới và muốn tra riêng trong trang tài liệu chính thức. Dùng tính năng giới hạn theo trang web, chỉ trỏ vào trang tài liệu đó, rồi hỏi cách dùng một hàm cụ thể. Kết quả sẽ tập trung vào đúng nguồn bạn tin cậy thay vì lẫn nhiều bài blog không rõ chất lượng.
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 hay Bing, README hướng dẫn thêm công cụ tìm kiếm tuỳ chỉnh trong cài đặt trình duyệt. Mở cài đặt, vào mục Search Engines, thêm một site search mới với URL sau:
http://localhost:3000/?q=%sNếu Vane chạy ở máy khác, thay localhost bằng địa chỉ IP hoặc tên miền, và thay cổng nếu cần. Sau đó bạn gõ thẳng câu hỏi vào thanh địa chỉ là ra câu trả lời của Vane. Lập trình viên muốn tích hợp vào ứng dụng riêng có thể xem tài liệu API trong docs/API/SEARCH.md của repo.
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 mô hình chat
Nếu bạn dùng một máy chủ AI cục bộ tương thích API OpenAI, README nêu ba điều cần kiểm tra. Một, máy chủ phải 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 phải đúng với model đang nạp trong máy chủ. Ba, ô API key không được để trống: nếu máy chủ không cần key, vẫn điền một giá trị bất kỳ.
B.Không kết nối được Ollama
Lỗi này thường do Vane (chạy trong Docker) không gọi được tới API của Ollama. Hãy kiểm tra lại API URL trong phần cài đặt. Theo README, trên Windows và Mac dùng http://host.docker.internal:11434. Đổi cổng nếu bạn dùng cổng khác. Với Linux, README ghi dòng địa chỉ nhưng bị mất mất phần máy chủ trong tư liệu mình có, nên bạn xem lại phần Troubleshooting trong README gốc.
C.Ollama trên Linux không nhận kết nối từ ngoài
Trên Linux, README hướng dẫn mở Ollama ra mạng: trong tệp /etc/systemd/system/ollama.service thêm dòng sau:
Environment="OLLAMA_HOST=0.0.0.0:11434"Sau đó tải lại cấu hình và khởi động lại Ollama:
systemctl daemon-reload
systemctl restart ollamaĐồng thời kiểm tra tường lửa không chặn cổng 11434. Bạn cần quyền quản trị để sửa tệp này, nên hãy chỉ sửa đúng dòng được hướng dẫn.
D.Lỗi kết nối Lemonade
Nếu bạn dùng Lemonade, cách xử lý tương tự Ollama. Kiểm tra API URL trong cài đặt. Trên Windows và Mac dùng http://host.docker.internal:8000. Đảm bảo máy chủ Lemonade đang chạy, chấp nhận kết nối từ 0.0.0.0 và cổng 8000 không bị tường lửa chặn.
E.Dùng SearxNG riêng nhưng Vane không tìm được
Khi chạy bản slim với SearxNG của riêng bạn, hãy chắc rằng SearxNG đã bật định dạng JSON và bật công cụ Wolfram Alpha, và địa chỉ trong SEARXNG_API_URL là đúng. README nói rõ đây là hai điều kiện bắt buộc.
VII.Có nên dùng không
Điểm mạnh. Vane miễn phí, giấy phép MIT, cài một lệnh bằng Docker. Dữ liệu và lịch sử được lưu cục bộ. Bạn chọn được model, từ chạy trên máy đến đám mây. Câu trả lời có nguồn nên kiểm chứng được. Ngoài giao diện web còn có API và có thể gắn vào thanh tìm kiếm trình duyệt.
Giới hạn. Vane không tự trả lời được nếu bạn chưa cấu hình một model AI. Chất lượng câu trả lời phụ thuộc vào model và kết quả tìm kiếm bạn dùng. Nếu dùng model đám mây thì câu hỏi vẫn được gửi tới nhà cung cấp đó, nên nói "hoàn toàn riêng tư" chỉ đúng khi bạn dùng model cục bộ. Ngoài ra, README liệt kê tính năng xác thực (authentication) là việc sẽ làm sau, nên nếu mở Vane ra mạng bạn nên cẩn thận ai truy cập được. README cũng không nêu yêu cầu cấu hình phần cứng.
Khi nào chọn cách khác. Nếu bạn chỉ cần tra cứu thỉnh thoảng và không muốn cài gì, dùng một dịch vụ tìm kiếm AI có sẵn trên web sẽ nhanh hơn. Nếu bạn cần nhiều người dùng với phân quyền tài khoản, hãy chờ hoặc tự bổ sung lớp bảo vệ. Còn nếu bạn muốn kiểm soát dữ liệu, tự chọn model và sẵn sàng chạy một container Docker, Vane là lựa chọn rất đáng 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ở theo giấy phép MIT nên dùng miễn phí. Tuy nhiên nếu bạn nối với model đám mây như OpenAI hay Claude thì có thể phát sinh chi phí theo bảng giá của nhà cung cấp đó. Dùng model cục bộ qua Ollama thì không tính phí API.
Vane có cần GPU không?
README không nêu yêu cầu GPU hay cấu hình phần cứng. Nếu bạn dùng model đám mây thì việc xử lý AI nằm ở phía nhà cung cấp. Nếu chạy model cục bộ bằng Ollama thì độ nặng tuỳ vào model bạn chọn, tư liệu 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 kết nối Ollama (dùng http://host.docker.internal:11434), nên chạy bằng Docker trên Windows là có hỗ trợ. Cách cài chính được khuyên dùng là Docker, nên bạn cần cài và bật Docker trước.
Dữ liệu và lịch sử tìm kiếm của tôi có an toàn không?
README mô tả Vane là công cụ chú trọng 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ộ. Nếu bạn dùng model đám mây, câu hỏi vẫn được gửi tới nhà cung cấp đó. Với model cục bộ như Ollama thì dữ liệu không rời khỏi máy bạn.
Vane khác gì Google hay các dịch vụ tìm kiếm AI khác?
Vane là công cụ bạn tự chạy: tự chọn model, tìm web qua SearxNG và có câu trả lời kèm nguồn trích dẫn. Tư liệu không so sánh chi tiết với dịch vụ cụ thể nào. Điểm khác chính là bạn tự kiểm soát mô hình và nơi lưu dữ liệu.
Cài Vane có khó không?
Với Docker thì rất đơn giản: một lệnh docker run, sau đó mở http://localhost:3000 và điền key, model trong màn hình thiết lập. Cách không dùng Docker phức tạp hơn vì bạn phải tự cài SearXNG và bật JSON cùng Wolfram Alpha, nên README khuyên dùng Docker.
Có thể gắn Vane vào ứng dụng của mình không?
Có. README nói Vane cung cấp API để chạy tìm kiếm, dùng nhiều model và nhận câu trả lời. Chi tiết nằm trong tài liệu docs/API/SEARCH.md của repo.


