Chuyển đến nội dung

assafelovic / gpt-researcher

GPT Researcher

Tác tử AI nghiên cứu sâu: tự tìm hàng chục nguồn trên web hoặc tài liệu của bạn rồi viết báo cáo có trích dẫn

GPT Researcher là một agent nghiên cứu mã nguồn mở. Bạn đưa ra một đề tài, nó chia thành nhiều câu hỏi nhỏ, đi thu thập thông tin song song từ web hoặc từ file của bạn, rồi tổng hợp thành báo cáo dài có nguồn. Bạn có thể chạy giao diện web trên máy, cài như thư viện Python, hoặc dùng qua Docker.

  • 30.731 sao
  • 4.230 fork
  • Python
  • Cập nhật 4 ngày trước
  • Apache 2.0 (dùng tự do, kể cả thương mại)
Độ khó
Vừa Cần gõ vài lệnh hoặc dùng Docker
Dạng
Web tự cài (self-host), Thư viện lập trình
Chạy trên
Python, Docker, Web, Windows, macOS, Linux
Chi phí
Miễn phí (trả phí API AI nếu dùng)

Trải nghiệm khi dùng GPT Researcher

Bạn tải mã nguồn về, đặt API key của mô hình (ví dụ OpenAI) và của công cụ tìm kiếm (README dùng Tavily) vào biến môi trường hoặc file .env, rồi chạy server. Mở trình duyệt vào địa chỉ localhost:8000 là có giao diện để nhập đề tài, ví dụ: Xu hướng thương mại điện tử Việt Nam năm nay có gì mới?

Sau khi bấm bắt đầu, bạn thấy hệ thống lần lượt lập câu hỏi, tìm nguồn, đọc và tóm tắt từng trang rồi gộp lại. Thay vì một câu trả lời ngắn như chat thông thường, kết quả là một báo cáo dài có nguồn, README nói có thể vượt 2.000 từ và tổng hợp trên 20 nguồn. Bạn có thể xuất ra PDF, Word và các định dạng khác.

Ngoài web, bạn có thể cho nó nghiên cứu trên chính tài liệu của mình: trỏ biến DOC_PATH tới thư mục chứa PDF, Word, Excel, CSV, Markdown hay PowerPoint rồi chọn nguồn My Documents trong giao diện.

Tính năng nổi bật

Nghiên cứu song song, có nguồn

Chia đề tài thành nhiều câu hỏi, thu thập và tóm tắt nguồn rồi gộp thành báo cáo có trích dẫn.

Nghiên cứu trên web hoặc tài liệu riêng

Đọc được PDF, văn bản, CSV, Excel, Markdown, PowerPoint và Word nằm trong thư mục bạn chỉ định.

Xuất báo cáo

Lưu kết quả ra PDF, Word và định dạng khác để gửi đồng nghiệp hoặc khách hàng.

Hai kiểu giao diện

Có giao diện nhẹ bằng HTML/CSS/JS và bản đầy đủ NextJS + Tailwind khi chạy bằng Docker.

Nối được MCP và mô hình tương thích OpenAI

Có thể kết hợp nguồn dữ liệu qua MCP (ví dụ GitHub) và dùng API tương thích OpenAI như mô hình cục bộ.

Dùng như thư viện Python

Cài bằng pip và gọi trong code của bạn để tự động hoá việc nghiên cứu.

Tận dụng GPT Researcher vào việc gì?

Chủ doanh nghiệp, marketing

Báo cáo nghiên cứu thị trường nhanh

Nhập một ngành hàng hay đối thủ cần tìm hiểu, nhận bản báo cáo nháp có liên kết nguồn để kiểm tra.

Sinh viên, nghiên cứu sinh

Tổng quan tài liệu cho bài luận

Dùng báo cáo làm điểm xuất phát để biết nên đọc nguồn nào, sau đó tự đọc và trích dẫn có chọn lọc.

Dân văn phòng, kế toán, phân tích

Phân tích tài liệu nội bộ

Cho nó đọc một thư mục báo cáo cũ để rút ra điểm chính thay vì mở từng file.

Lập trình viên

Tự động hoá nghiên cứu trong ứng dụng

Tích hợp thư viện vào hệ thống nội bộ để tạo báo cáo định kỳ theo chủ đề.

Người dùng Claude

Công cụ cho Claude

README có hướng dẫn cài GPT Researcher như một Claude Skill để mở rộng khả năng nghiên cứu.

Cần chuẩn bị gì?

  • Python 3.12 trở lên nếu chạy từ mã nguồn, hoặc Docker nếu dùng docker compose.
  • API key của mô hình ngôn ngữ (ví dụ OpenAI) và của dịch vụ tìm kiếm (README dùng Tavily).
  • Kết nối Internet; mỗi báo cáo sẽ tiêu tốn lượng token đáng kể vì đọc nhiều nguồn.

Hướng dẫn cài đặt chi tiết

Cài trên Python

  1. Cài Python 3.12 trở lên rồi tải mã nguồn.

    Terminal
    git clone https://github.com/assafelovic/gpt-researcher.git
    cd gpt-researcher
  2. Đặt API key. Thay chữ in hoa bằng key thật của bạn; có thể lưu vào file .env thay vì export.

    Terminal
    export OPENAI_API_KEY=YOUR_OPENAI_KEY
    export TAVILY_API_KEY=YOUR_TAVILY_KEY
  3. Trên Windows PowerShell, đặt biến môi trường theo cú pháp sau (thay YOUR_... bằng key thật).

    PowerShell
    $env:OPENAI_API_KEY = "YOUR_OPENAI_KEY"
    $env:TAVILY_API_KEY = "YOUR_TAVILY_KEY"
  4. Cài thư viện và khởi động server, sau đó mở http://localhost:8000.

    Terminal
    pip install -r requirements.txt
    python -m uvicorn main:app --reload

Cài trên Docker

  1. Cài Docker, rồi sao chép file .env.example thành .env và điền API key vào đó.

  2. Trong thư mục repo, chạy lệnh dưới (nếu không được, thử bỏ dấu gạch ngang: docker compose).

    Terminal
    docker-compose up --build
  3. Mặc định chạy hai tiến trình: server Python ở localhost:8000 và ứng dụng React ở localhost:3000. Mở localhost:3000 để bắt đầu.

Cài trên pip (thư viện)

  1. Cài gói để dùng trong code Python của bạn.

    Terminal
    pip install gpt-researcher
  2. Xem ví dụ GPTResearcher trong README hoặc trang docs.gptr.dev để biết cách gọi conduct_research và write_report.

Dùng thử lần đầu

  1. Chạy server theo một trong các cách ở trên rồi mở localhost:8000 (hoặc localhost:3000 nếu dùng Docker).

  2. Nhập một đề tài cụ thể thay vì chung chung, ví dụ: So sánh các nền tảng bán hàng đa kênh cho shop nhỏ tại Việt Nam.

  3. Chờ hệ thống tìm và tổng hợp. Khi xong, đọc báo cáo và mở các liên kết nguồn để kiểm tra những ý quan trọng.

  4. Thử nguồn My Documents: đặt DOC_PATH trỏ tới thư mục tài liệu của bạn rồi chạy lại một nghiên cứu.

    Terminal
    export DOC_PATH="./my-docs"
  5. Xuất báo cáo ra PDF hoặc Word nếu giao diện cho phép.

Mẹo dùng hay

  • Câu hỏi càng cụ thể và có phạm vi rõ (thị trường, thời gian) thì báo cáo càng sát nhu cầu.
  • Nếu muốn dùng mô hình cục bộ hay nhà cung cấp khác tương thích OpenAI, README cho phép đặt OPENAI_BASE_URL.
  • Xem docs.gptr.dev để chọn công cụ tìm kiếm và mô hình khác thay cho mặc định.

Lưu ý và hạn chế

  • Báo cáo vẫn do AI viết nên có thể sai hoặc thiên lệch, hãy kiểm tra nguồn quan trọng trước khi đưa vào tài liệu chính thức.
  • Mỗi lần nghiên cứu sâu có thể tốn khá nhiều token và phí tìm kiếm; hãy theo dõi chi phí ở trang của hãng API.
  • Việc thu thập nội dung từ web cần tôn trọng điều khoản và bản quyền của từng trang, đặc biệt khi dùng nội dung vào mục đích thương mại.

Câu hỏi thường gặp

GPT Researcher có miễn phí không?

Mã nguồn dùng giấy phép Apache-2.0 và chạy tự do, nhưng bạn trả phí API cho mô hình và dịch vụ tìm kiếm bạn chọn.

Có viết báo cáo tiếng Việt được không?

README không nói riêng về tiếng Việt; khả năng này phụ thuộc mô hình bạn dùng. Bạn có thể thử bằng cách đặt câu hỏi và yêu cầu báo cáo bằng tiếng Việt.

Dữ liệu của tôi có bị gửi đi không?

Nội dung đề tài và đoạn tài liệu liên quan sẽ được gửi tới nhà cung cấp mô hình và công cụ tìm kiếm bạn chọn. Muốn kín hơn hãy dùng mô hình chạy cục bộ và lọc tài liệu nhạy cảm.

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/assafelovic/gpt-researcher.git

Repo tương tự nên xem

Trợ lý & chat AI31,9K

STORM và Co-STORM

stanford-oval / storm

Hệ thống AI của Stanford tự tìm tài liệu trên web rồi viết bài dài kiểu Wikipedia có trích dẫn

KhóPythonWeb
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
AI Agent & tự động hoá161K

Dify

langgenius / dify

Nền tảng kéo thả để dựng ứng dụng AI, chatbot hỏi đáp tài liệu và quy trình tự động, tự cài bằng Docker

VừaDockerWebLinuxWindows+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 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 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 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 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

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