Trải nghiệm khi dùng Khoj
Cách nhanh nhất để làm quen là vào app.khoj.dev, bản cloud do chính nhóm Khoj chạy, đăng nhập và bắt đầu hỏi. README xác nhận bạn không cần tự cài gì để dùng. Khi đã thấy hợp, bạn mới tính chuyện tự cài trên máy để dữ liệu không rời khỏi mạng nội bộ.
Khi tự cài, bạn tải một file docker-compose.yml, điền mật khẩu quản trị và API key (OpenAI, Anthropic hoặc Gemini), hoặc trỏ tới Ollama chạy trên máy, rồi bật bằng một lệnh. Sau đó bạn vào trang web của Khoj, kết nối thư mục tài liệu và bắt đầu hỏi những câu như: Hợp đồng nào có điều khoản phạt chậm thanh toán?
Ngoài chat, Khoj có thể tạo agent riêng (với vai trò, kiến thức và công cụ riêng), tìm kiếm ngữ nghĩa trong ghi chú, tạo bản tin hay thông báo tự động và thậm chí đọc to tin nhắn. Nếu bạn dùng Obsidian, có thể hỏi trực tiếp ngay trong ứng dụng ghi chú.
Tính năng nổi bật
Hỏi đáp trên tài liệu cá nhân
Đọc PDF, Markdown, Word, Notion, org-mode và hơn nữa rồi trả lời dựa trên nội dung của bạn.
Tìm trên web khi cần
Kết hợp thông tin từ Internet với tài liệu riêng trong cùng một cuộc trò chuyện.
Dùng nhiều mô hình
Hỗ trợ mô hình cục bộ hoặc trực tuyến như Llama, Qwen, Gemma, Mistral, GPT, Claude, Gemini, DeepSeek.
Agent tuỳ chỉnh
Tạo trợ lý có tính cách, kiến thức, mô hình và công cụ riêng cho từng vai trò, như gia sư hay nhà nghiên cứu.
Truy cập từ nhiều nơi
Trình duyệt, Obsidian, Emacs, ứng dụng máy tính, điện thoại và WhatsApp.
Tự động hoá nghiên cứu
Nhận bản tin cá nhân hoá và thông báo thông minh gửi về hộp thư.
Tận dụng Khoj vào việc gì?
Dân văn phòng, kế toán, pháp chế
Hỏi lại kho tài liệu công việc
Gom hợp đồng, quy trình, báo cáo vào một chỗ rồi hỏi bằng tiếng thường để tìm đúng đoạn cần.
Người dùng Obsidian, Notion
Bộ não thứ hai cho ghi chú
Hỏi những điều bạn từng ghi mà quên, nhận câu trả lời kèm nơi nó nằm.
Sinh viên
Gia sư cá nhân từ tài liệu học
Tải giáo trình, bài giảng lên rồi nhờ tóm tắt hoặc giải thích những phần khó.
Chủ shop online, marketing
Nghiên cứu thị trường tự động
Nhờ agent tìm tin mới về một chủ đề và gửi bản tin định kỳ.
Người quan tâm riêng tư
Trợ lý riêng chạy offline
Kết hợp với Ollama để giữ cả mô hình và dữ liệu trong máy mình.
Cần chuẩn bị gì?
- Docker (và trên Windows là WSL2) nếu tự cài bằng Docker; hoặc Python nếu cài bằng pip.
- API key OpenAI, Anthropic hay Gemini, hoặc mô hình cục bộ (Ollama, LM Studio...) nếu không dùng bản cloud.
- RAM và card đồ hoạ đủ mạnh nếu bạn tự chạy mô hình lớn trên máy.
Hướng dẫn cài đặt chi tiết
Cài trên Bản cloud
Không cần cài gì: vào trang ứng dụng và đăng nhập để dùng ngay.
https://app.khoj.dev
Cài trên Docker (macOS, Linux)
Cài Docker Desktop (hoặc Docker Engine cùng Docker Compose trên Linux).
Tạo thư mục và tải file docker-compose.yml chính thức.
mkdir ~/.khoj && cd ~/.khoj wget https://raw.githubusercontent.com/khoj-ai/khoj/master/docker-compose.ymlMở file docker-compose.yml và đặt các giá trị KHOJ_ADMIN_PASSWORD, KHOJ_DJANGO_SECRET_KEY an toàn. Điền OPENAI_API_KEY, ANTHROPIC_API_KEY hoặc GEMINI_API_KEY nếu dùng mô hình trực tuyến, hoặc bỏ chú thích OPENAI_BASE_URL để trỏ tới Ollama.
Chạy Khoj. Theo tài liệu, hãy khởi động lại server một lần sau lần chạy đầu để mọi cài đặt có hiệu lực.
cd ~/.khoj docker-compose up
Cài trên Docker (Windows)
Cài WSL2 bằng PowerShell rồi khởi động lại máy.
wsl --installCài Docker Desktop với WSL2 backend (mặc định).
Mở cửa sổ dòng lệnh WSL2 (theo docs, các lệnh Khoj chạy trong WSL2) và tải file cấu hình.
mkdir ~/.khoj && cd ~/.khoj wget https://raw.githubusercontent.com/khoj-ai/khoj/master/docker-compose.ymlSửa các biến môi trường như hướng dẫn ở tab macOS rồi chạy.
docker-compose up
Cài trên pip
Khoj cũng có gói trên PyPI. Hướng dẫn cài bằng pip đầy đủ nằm ở trang docs, xem phần Pip trong mục Self-Host.
https://docs.khoj.dev/get-started/setup
Dùng thử lần đầu
Mở Khoj trong trình duyệt. Mặc định nó chỉ truy cập được trên máy đang chạy; muốn dùng từ máy khác phải xem tài liệu Remote Access.
Vào khu quản trị bằng mật khẩu bạn đã đặt để kiểm tra mô hình chat đang dùng, hoặc cấu hình thêm mô hình.
Thêm một vài tài liệu (PDF hoặc ghi chú Markdown) vào Khoj theo hướng dẫn trong phần Features của docs.
Hỏi một câu cụ thể về nội dung tài liệu, ví dụ: Tóm tắt các điểm chính trong file báo cáo quý này.
Thử tạo một agent riêng cho một vai trò, ví dụ trợ lý soạn email tiếng Việt.
Mẹo dùng hay
- Khởi động lại server sau lần chạy đầu tiên như tài liệu nhắc để cài đặt được áp dụng đúng.
- Muốn dùng Ollama đang chạy trên máy, bỏ chú thích OPENAI_BASE_URL trong docker-compose.yml theo hướng dẫn của Khoj.
- Khi mới thử, hãy dùng bản cloud trước để hiểu tính năng rồi mới mất công tự cài.
Lưu ý và hạn chế
- Giấy phép AGPL-3.0: nếu bạn sửa code rồi cung cấp dịch vụ cho người khác qua mạng, cần tuân thủ điều kiện chia sẻ mã nguồn.
- Lần commit gần nhất của repo là vài tháng trước (tháng 8 năm 2026 theo dữ liệu danh sách); hãy kiểm tra trang Releases và issues trước khi triển khai nghiêm túc.
- Bản tự cài cần kiến thức Docker cơ bản; Windows còn phải qua WSL2 theo tài liệu.
Câu hỏi thường gặp
Khoj có miễn phí không?
Mã nguồn mở và tự cài thì miễn phí, nhưng nếu nối API của OpenAI, Anthropic, Gemini bạn trả phí cho hãng đó. Bản cloud có thể có gói trả phí, xem trang chính thức khoj.dev.
Khoj có chạy offline được không?
README nói bạn có thể dùng Khoj không cần Internet nếu triển khai trên máy cá nhân, tuỳ vào mô hình chạy cục bộ bạn chọn.
Hỏi bằng tiếng Việt được không?
Có thể, vì khả năng tiếng Việt phụ thuộc mô hình AI bạn chọn. Mô hình lớn như GPT, Claude, Gemini hay Qwen thường xử lý tiếng Việt tốt hơn mô hình nhỏ.
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/khoj-ai/khoj.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
Open WebUI
open-webui / open-webui
Giao diện chat AI kiểu ChatGPT tự cài trên máy của bạn, nối được với Ollama và các API AI khác
Vane (trước đây là Perplexica)
ItzCrazyKns / Vane
Công cụ trả lời có dẫn nguồn kiểu Perplexity, tự cài trên máy mình và dùng được mô hình Ollama