Chuyển đến nội dung

khoj-ai / khoj

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

Khoj là một ứng dụng AI cá nhân: bạn chat với mô hình bạn chọn, và nó trả lời dựa trên cả Internet lẫn tài liệu của bạn như PDF, Markdown, Word, Notion hay org-mode. Dùng được qua trình duyệt, Obsidian, Emacs, ứng dụng máy tính, điện thoại và WhatsApp. Bạn có thể tự cài (giấy phép AGPL-3.0) hoặc dùng bản cloud của họ.

  • 38.143 sao
  • 2.554 fork
  • Python
  • Cập nhật 3 tháng trước
  • AGPL 3.0 (chạy dịch vụ cũng phải công bố mã)
Độ khó
Vừa Cần gõ vài lệnh hoặc dùng Docker
Dạng
Web tự cài (self-host), Ứng dụng máy tính
Chạy trên
Docker, Python, Windows, macOS, Linux, Web
Chi phí
Miễn phí, có bản trả phí

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

  1. Không cần cài gì: vào trang ứng dụng và đăng nhập để dùng ngay.

    Văn bản
    https://app.khoj.dev

Cài trên Docker (macOS, Linux)

  1. Cài Docker Desktop (hoặc Docker Engine cùng Docker Compose trên Linux).

  2. Tạo thư mục và tải file docker-compose.yml chính thức.

    Terminal
    mkdir ~/.khoj && cd ~/.khoj
    wget https://raw.githubusercontent.com/khoj-ai/khoj/master/docker-compose.yml
  3. Mở 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.

  4. 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.

    Terminal
    cd ~/.khoj
    docker-compose up

Cài trên Docker (Windows)

  1. Cài WSL2 bằng PowerShell rồi khởi động lại máy.

    PowerShell
    wsl --install
  2. Cài Docker Desktop với WSL2 backend (mặc định).

  3. 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.

    Terminal
    mkdir ~/.khoj && cd ~/.khoj
    wget https://raw.githubusercontent.com/khoj-ai/khoj/master/docker-compose.yml
  4. Sửa các biến môi trường như hướng dẫn ở tab macOS rồi chạy.

    Terminal
    docker-compose up

Cài trên pip

  1. 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.

    Văn bản
    https://docs.khoj.dev/get-started/setup

Dùng thử lần đầu

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

Terminal
git clone https://github.com/khoj-ai/khoj.git

Repo tương tự nên xem

Trợ lý & chat AI68,3K

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

DễWindowsmacOSLinuxDocker+1
Trợ lý & chat AI159K

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

VừaDockerPythonWindowsmacOS+1
Trợ lý & chat AI38,2K

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

VừaDockerNode.jsWindowsmacOS+1

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: Trợ lý & chat AI

Trợ lý & chat AI89K

NextChat (ChatGPT Next Web)

ChatGPTNextWeb / NextChat

Giao diện chat AI gọn nhẹ, tự dựng bằng khoá API của bạn, có sẵn bản máy tính, web và iOS

VừaWindowsmacOSLinuxiOS+2
Trợ lý & chat AI85,6K

LobeHub

lobehub / lobehub

Không gian làm việc với nhiều tác tử AI (agent) làm cùng nhóm bạn, dùng đám mây hoặc tự cài bằng Docker

VừaWebDockerWindowsmacOS+1
Trợ lý & chat AI53,6K

Cherry Studio

CherryHQ / cherry-studio

Ứng dụng máy tính gom nhiều mô hình AI, agent, kho tri thức và dịch thuật vào một chỗ

DễWindowsmacOSLinuxAndroid+1
Trợ lý & chat AI47,7K

TextGen (text-generation-webui)

oobabooga / textgen

Ứng dụng chạy mô hình ngôn ngữ trên máy, giải nén là dùng, riêng tư tuyệt đối và không thu thập dữ liệu

VừaWindowsmacOSLinuxPython
Trợ lý & chat AI47,2K

LibreChat

LibreChat-AI / LibreChat

Bản "ChatGPT tự dựng" nhiều người dùng, nối OpenAI, Claude, Gemini, Ollama... trong một giao diện duy nhất

VừaWebDockerWindowsmacOS+1
Trợ lý & chat AI45,7K

Jan

janhq / jan

Ứng dụng thay thế ChatGPT mã nguồn mở, chạy mô hình AI ngay trên máy tính của bạn

DễWindowsmacOSLinux

Xem cả 18 repo Trợ lý & chat AI Về Kho Repo