# Dexter: agent nghiên cứu tài chính tự động, chạy ngay trong terminal — hướng dẫn cài đặt và dùng

> Dexter là một agent tự động chuyên nghiên cứu tài chính, viết bằng TypeScript, chạy trong terminal bằng Bun. Bạn đặt câu hỏi, nó tự chia việc, lấy dữ liệu báo cáo tài chính và tổng hợp câu trả lời. Cài không quá khó (clone, bun install, điền API key) nhưng cần ít nhất một key mô hình AI và key dữ liệu tài chính.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-09-13 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/dexter-agent-nghien-cuu-tai-chinh-tu-dong-2

Dexter là một agent AI chuyên nghiên cứu tài chính. Bạn hỏi một câu phức tạp, nó tự chia thành các bước, tự lấy dữ liệu thị trường, tự kiểm tra lại và trả lời bằng số liệu. README mô tả nó là "Claude Code nhưng làm riêng cho nghiên cứu tài chính". Repo viết bằng TypeScript, chạy trong terminal.

Bạn nên xem qua nếu đang làm phân tích cổ phiếu, theo dõi doanh nghiệp, hoặc chỉ tò mò muốn thấy một agent AI làm việc "có quy trình" thay vì trả lời một lần rồi thôi. Người làm kinh doanh, nhân viên văn phòng hay lập trình viên mới đều thử được, miễn là bạn không ngại gõ vài dòng lệnh.

Điểm đáng giá nhất là cách nó làm việc: lập kế hoạch, chạy công cụ, tự soát lỗi, lặp lại đến khi xong. Repo hiện có khoảng 27.828 sao và 3.435 fork, vẫn được cập nhật trong 3 tháng gần đây. Xem video ngắn bên dưới để thấy nó chạy thế nào.

```note
README ghi rõ: dự án chỉ dành cho mục đích học tập, giải trí và tham khảo. Đây không phải lời khuyên đầu tư, kết quả có thể sai, thiếu hoặc lỗi thời. Đừng dùng nó để quyết định giao dịch thật mà không có người có chuyên môn kiểm tra.
```

```repo
- repo | virattt/dexter
- kind | Agent
- desc | Dexter là agent AI nghiên cứu tài chính: tự lập kế hoạch, lấy dữ liệu thị trường thật, tự kiểm tra kết quả rồi trả lời bằng số liệu.
- stars | 28k
- lang | TypeScript
```

```video
- youtube | https://youtube.com/shorts/4RveBq8onBM
- facebook | https://www.facebook.com/reel/4626268204252907
- title | Video giới thiệu dexter
```

## Dexter làm được gì

Dưới đây là các khả năng chính theo README, mình giải thích theo hướng bạn dùng được gì.

### Tự chia câu hỏi lớn thành các bước nhỏ

Bạn không cần tự nghĩ "trước tiên lấy cái này, sau đó so sánh cái kia". Dexter tự phân rã câu hỏi phức tạp thành các bước nghiên cứu có cấu trúc. Nhờ vậy bạn có thể hỏi bằng ngôn ngữ thường, như hỏi một người trợ lý.

### Tự chọn công cụ và lấy dữ liệu

Nó tự quyết định dùng công cụ nào để gom dữ liệu tài chính. README nhắc đến báo cáo kết quả kinh doanh, bảng cân đối kế toán và báo cáo lưu chuyển tiền tệ. Dữ liệu này đến từ dịch vụ Financial Datasets nên bạn cần key của dịch vụ đó.

### Tự kiểm tra và làm lại

Sau khi lấy dữ liệu, Dexter kiểm tra công việc của chính nó và lặp lại cho đến khi xong. Việc này giúp giảm kiểu trả lời qua loa, dù không đảm bảo đúng 100%.

### Có "phanh an toàn"

Repo có sẵn cơ chế phát hiện vòng lặp và giới hạn số bước, để agent không chạy mãi (và không đốt tiền API vô ích).

### Nhiều lựa chọn mô hình AI

File mẫu cấu hình có chỗ điền key cho OpenAI, Anthropic, Google, xAI, OpenRouter, Moonshot, DeepSeek. Ngoài ra còn có Ollama, tức mô hình chạy trên máy bạn. Bạn chọn nhà cung cấp nào cũng được, không bị khóa vào một hãng.

### Tìm kiếm web

Ngoài dữ liệu tài chính, Dexter có thể tìm web qua Exa (ưu tiên) hoặc Tavily (dự phòng). Phần này là tùy chọn.

### Ghi lại mọi thứ để bạn kiểm tra

Mỗi câu hỏi tạo một file nhật ký, ghi lại câu hỏi gốc, từng lần gọi công cụ và các bước suy luận. Bạn có thể mở ra xem nó đã lấy dữ liệu gì và hiểu ra sao.

### Đo chất lượng và dùng qua WhatsApp

Repo có bộ đánh giá chạy trên tập câu hỏi tài chính, dùng LangSmith để theo dõi. Ngoài ra bạn có thể nhắn tin cho Dexter qua WhatsApp bằng cách liên kết điện thoại với một gateway.

## Cần chuẩn bị gì

Theo README, bạn cần:

- **Bun** (môi trường chạy JavaScript/TypeScript), phiên bản 1.0 trở lên.
- **API key của OpenAI** (README ghi là key chính). Nếu muốn dùng hãng khác, file mẫu cấu hình có chỗ cho Anthropic, Google, xAI, OpenRouter và các hãng khác.
- **API key của Financial Datasets** để lấy dữ liệu thị trường.
- **API key của Exa**: tùy chọn, dùng cho tìm kiếm web.
- Nếu muốn chạy mô hình trên máy bằng Ollama thì cần có Ollama và điền địa chỉ của nó.

README có hướng dẫn cài Bun cho macOS, Linux và Windows, nên bạn dùng được trên cả ba hệ điều hành. Phần cứng (RAM, GPU) README không nói gì. Nếu dùng mô hình qua đám mây thì máy bạn không cần mạnh, còn Ollama chạy local thì chưa có thông tin yêu cầu cấu hình.

```note
API key giống mật khẩu và gắn với tài khoản tính tiền của bạn. Đừng gửi file .env cho người khác, đừng đưa lên GitHub. Mỗi câu hỏi có thể gọi mô hình AI nhiều lần nên có thể tốn phí, hãy đặt hạn mức chi tiêu trong tài khoản nhà cung cấp.
```

## Cài đặt từng bước

```steps
- Cài Bun | Cài môi trường chạy Bun rồi mở lại terminal
- Tải mã nguồn | Dùng git clone và vào thư mục dexter
- Cài thư viện | Chạy bun install
- Điền API key | Sao chép env.example thành .env và điền key
- Chạy | Gõ bun start để vào chế độ tương tác
```

### Cài Bun

"Terminal" là cửa sổ gõ lệnh. Trên Windows bạn mở PowerShell, trên macOS/Linux mở Terminal. Lệnh dưới đây là của README cho Windows:

```powershell
powershell -c "irm bun.sh/install.ps1|iex"
```

Nếu bạn dùng macOS hoặc Linux, README ghi lệnh này:

```bash
curl -fsSL https://bun.com/install | bash
```

Cài xong, hãy **đóng terminal và mở lại**. Đây là chỗ người mới hay vấp, vì terminal cũ chưa biết đến Bun. Rồi kiểm tra:

```bash
bun --version
```

Nếu hiện ra số phiên bản (từ 1.0 trở lên) là ổn.

### Tải mã nguồn về máy

Bạn cần có Git. Lệnh sau tải repo về và đi vào thư mục của nó:

```bash
git clone https://github.com/virattt/dexter.git
cd dexter
```

Từ giờ mọi lệnh bên dưới đều phải chạy **trong thư mục dexter** này.

### Cài thư viện phụ thuộc

```bash
bun install
```

Lệnh này tải các thư viện mà Dexter cần. Lần đầu có thể mất một lúc, tùy tốc độ mạng.

### Tạo file .env và điền key

Repo có file mẫu tên `env.example`. Bạn sao chép nó thành `.env` (file thật chứa key):

```bash
# Copy the example environment file
cp env.example .env
```

Sau đó mở file `.env` bằng trình soạn thảo bất kỳ (Notepad, VS Code…) và điền key. README liệt kê các dòng sau, bạn chỉ cần điền loại bạn có:

```bash
# OPENAI_API_KEY=your-openai-api-key
# ANTHROPIC_API_KEY=your-anthropic-api-key (optional)
# GOOGLE_API_KEY=your-google-api-key (optional)
# XAI_API_KEY=your-xai-api-key (optional)
# OPENROUTER_API_KEY=your-openrouter-api-key (optional)

# Institutional-grade market data for agents
# FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key

# (Optional) If using Ollama locally
# OLLAMA_BASE_URL=http://127.0.0.1:11434

# Web Search (Exa preferred, Tavily fallback)
# EXASEARCH_API_KEY=your-exa-api-key
# TAVILY_API_KEY=your-tavily-api-key
```

Lưu ý cho người mới: các dòng này trong file mẫu có thể đang bắt đầu bằng dấu `#`. Dấu `#` nghĩa là ghi chú, chương trình sẽ bỏ qua. Khi điền key, hãy xem kỹ dòng đó trong file `env.example` của bạn. Dòng nào bạn dùng thì phải ở dạng `TÊN_BIẾN=key-của-bạn`, không để `#` ở đầu. Tối thiểu bạn cần key mô hình AI (ví dụ OPENAI_API_KEY) và FINANCIAL_DATASETS_API_KEY.

Trên Windows, nếu lệnh `cp` không chạy được, bạn có thể copy file `env.example` bằng File Explorer rồi đổi tên bản sao thành `.env`. Đây là cách làm thủ công, không nằm trong README.

### Chạy Dexter

Chế độ tương tác (dùng bình thường):

```bash
bun start
```

Chế độ watch, dành cho người phát triển (tự chạy lại khi sửa code):

```bash
bun dev
```

Người dùng bình thường chỉ cần `bun start`.

## Kiểm tra đã chạy được chưa

README không mô tả chi tiết màn hình khởi động, nên mình chỉ nêu những gì kiểm chứng được:

1. `bun --version` in ra số phiên bản.
2. `bun install` chạy xong không báo lỗi đỏ.
3. `bun start` mở ra giao diện tương tác trong terminal và không thoát ngay với thông báo lỗi.
4. Bạn gõ một câu hỏi đơn giản về tài chính và nhận được câu trả lời có số liệu.

Bạn còn có một cách kiểm tra khác theo README: sau khi hỏi, vào thư mục `.dexter/scratchpad/` trong repo. Nếu thấy file `.jsonl` mới xuất hiện, nghĩa là Dexter đã xử lý câu hỏi và ghi lại các bước. Mỗi file ghi câu hỏi gốc (init), từng lần gọi công cụ (tool_result) và các bước suy luận (thinking).

## Dùng vào việc thật

Bối cảnh bên dưới là ví dụ minh họa dựa trên khả năng README mô tả. Câu hỏi mẫu là gợi ý của mình, README không đưa sẵn prompt nào. Hãy coi kết quả là bản nháp để bạn kiểm tra lại.

### Nhà đầu tư cá nhân muốn hiểu nhanh một công ty

Bạn đang xem một công ty niêm yết và muốn biết tình hình kinh doanh mấy năm gần đây. Sau khi chạy `bun start`, bạn gõ câu hỏi như:

```text
Tóm tắt doanh thu và lợi nhuận 5 năm gần nhất của Apple, nhận xét xu hướng.
```

Dexter sẽ tự gọi công cụ lấy báo cáo kết quả kinh doanh nhiều năm rồi tổng hợp. Trong ví dụ trong README, nhật ký ghi lại việc lấy báo cáo thu nhập hằng năm của mã AAPL kèm một câu tóm tắt xu hướng doanh thu. Bạn nhận được một đoạn phân tích có số liệu thay vì phải tự mở từng báo cáo.

> Hỏi một câu thường, nhận lại một kế hoạch nghiên cứu có số liệu: đó là khác biệt giữa chatbot và agent.
>
> — Ông T

### Nhân viên văn phòng chuẩn bị tài liệu cho buổi họp

Bạn phải chuẩn bị phần so sánh hai công ty trong cùng ngành cho sếp. Thay vì tự gom số từ nhiều nơi, bạn nhờ Dexter so sánh các chỉ số trong báo cáo tài chính của hai công ty:

```text
So sánh bảng cân đối kế toán và dòng tiền của hai công ty A và B, chỉ ra điểm khác biệt chính.
```

Kết quả là bản so sánh nháp. Bạn mở file trong `.dexter/scratchpad/` để xem nó lấy số liệu nào, rồi đối chiếu với nguồn gốc trước khi đưa vào tài liệu.

### Lập trình viên muốn kiểm tra chất lượng agent

Nếu bạn sửa hoặc đổi mô hình AI cho Dexter, README có sẵn bộ đánh giá. Chạy trên toàn bộ câu hỏi:

```bash
bun run src/evals/run.ts
```

Hoặc chỉ chạy thử trên 10 câu ngẫu nhiên cho nhanh:

```bash
bun run src/evals/run.ts --sample 10
```

Giao diện hiện tiến độ, câu hỏi đang chạy và độ chính xác tạm tính. Kết quả được ghi lên LangSmith, nên bạn cần có tài khoản và key của LangSmith (các biến LANGSMITH_* có trong file mẫu). Cách này giúp bạn biết đổi mô hình hay chỉnh code thì tốt lên hay tệ đi.

### Hỏi Dexter ngay trên điện thoại qua WhatsApp

Nếu muốn hỏi khi đang di chuyển, README có chế độ gateway WhatsApp. Bạn liên kết tài khoản bằng cách quét mã QR:

```bash
bun run gateway:login
```

Sau đó bật gateway:

```bash
bun run gateway
```

Rồi mở WhatsApp, vào khung chat với chính mình và đặt câu hỏi. Dexter xử lý và trả lời ngay trong khung chat đó. Máy chạy gateway phải đang bật. Cấu hình chi tiết nằm trong tài liệu WhatsApp Gateway của repo.

## Lỗi hay gặp và cách xử lý

### Gõ bun mà báo "không nhận ra lệnh"

Thường là bạn chưa mở lại terminal sau khi cài Bun. Hãy đóng hẳn cửa sổ terminal, mở cái mới rồi chạy `bun --version`. Nếu vẫn lỗi, chạy lại lệnh cài Bun ở trên.

### Chạy được nhưng báo thiếu hoặc sai API key

Kiểm tra file `.env`: tên biến có đúng không, có còn dấu `#` ở đầu dòng không, key có bị thừa dấu cách hoặc thiếu ký tự không. Với bản chạy cơ bản, bạn cần ít nhất key mô hình AI và FINANCIAL_DATASETS_API_KEY. Sau khi sửa `.env`, hãy tắt Dexter và chạy lại `bun start`.

### Lệnh bị chạy sai thư mục

Nếu `bun install` hay `bun start` báo không tìm thấy gì, có thể bạn chưa vào thư mục dexter. Hãy chạy `cd dexter` (hoặc `cd` đến đúng nơi bạn đã clone repo) rồi thử lại.

### Câu trả lời sai hoặc dữ liệu cũ

README cảnh báo thẳng rằng kết quả có thể sai, thiếu hoặc lỗi thời. Cách an toàn: mở file nhật ký trong `.dexter/scratchpad/` xem nó lấy dữ liệu gì, rồi đối chiếu với báo cáo gốc của doanh nghiệp trước khi dùng. Đừng dùng thẳng kết quả để ra quyết định đầu tư.

### Tốn phí API nhiều hơn dự kiến

Agent có thể gọi mô hình AI và công cụ nhiều lần cho một câu hỏi. Hãy đặt hạn mức chi tiêu ở trang quản lý của nhà cung cấp, và thử bằng câu hỏi ngắn trước. Repo có giới hạn số bước và phát hiện vòng lặp, nhưng chi phí cụ thể README không nêu.

## Có nên dùng không

**Điểm mạnh.** Dexter cho bạn thấy một agent làm việc có quy trình: lập kế hoạch, lấy dữ liệu thật, tự kiểm tra, ghi nhật ký để soát lại. Nó cho chọn nhiều nhà cung cấp mô hình, kể cả Ollama chạy trên máy. Cách cài khá thẳng: clone, `bun install`, điền key, `bun start`. Repo còn có bộ đánh giá và gateway WhatsApp, và vẫn được cập nhật.

**Giới hạn.** Bạn phải gõ lệnh trong terminal, chưa có giao diện cửa sổ. Bạn cần ít nhất hai loại key (mô hình AI và dữ liệu tài chính), và có thể phát sinh phí. README ghi giấy phép MIT, nhưng mục giấy phép của repo trong thông tin mình có lại không ghi rõ, nên nếu định dùng thương mại bạn hãy tự kiểm tra file giấy phép. Phạm vi dữ liệu theo README là báo cáo tài chính (kết quả kinh doanh, cân đối kế toán, dòng tiền). Dữ liệu thị trường Việt Nam có được hỗ trợ không thì mình chưa có thông tin.

**Khi nào chọn cách khác.** Nếu bạn chỉ cần tra nhanh vài con số, mở trang dữ liệu tài chính quen thuộc sẽ nhanh hơn. Nếu bạn cần công cụ để giao dịch thật hoặc cần độ chính xác đảm bảo, đừng dựa vào Dexter, vì chính tác giả nói nó chỉ để học tập và tham khảo. Còn nếu bạn muốn học cách xây agent nghiên cứu, đọc code TypeScript và nhật ký scratchpad thì đây là một repo rất đáng thử.

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

### Dexter có miễn phí không?

Bản thân repo tải về được và README ghi giấy phép MIT. Nhưng để chạy bạn cần API key của mô hình AI (ví dụ OpenAI) và của Financial Datasets, là các dịch vụ bên ngoài có thể tính phí. Mức phí cụ thể README không nêu, bạn xem trang của từng nhà cung cấp.

### Dexter có cần GPU không?

README không yêu cầu GPU. Nếu dùng mô hình qua đám mây thì máy bạn chỉ cần chạy được Bun. Nếu muốn dùng Ollama chạy trên máy, yêu cầu cấu hình chưa có trong tư liệu.

### Dexter chạy được trên Windows không?

Được theo README. Phần cài Bun có lệnh riêng cho Windows bằng PowerShell, và các lệnh còn lại (bun install, bun start) giống nhau trên các hệ điều hành. Nếu lệnh cp không chạy trên máy bạn, có thể copy và đổi tên file env.example thành .env bằng tay.

### Dữ liệu và câu hỏi của tôi có an toàn không?

Dexter chạy trên máy bạn nhưng câu hỏi và dữ liệu sẽ được gửi tới các dịch vụ bạn cấu hình, như nhà cung cấp mô hình AI và Financial Datasets. Mọi lần gọi công cụ được lưu thành file trong thư mục .dexter/scratchpad/ trên máy bạn. README chưa có phần nói riêng về quyền riêng tư, nên hãy tự đọc điều khoản của từng dịch vụ.

### Dexter khác gì hỏi thẳng ChatGPT?

Theo README, Dexter chia câu hỏi thành các bước, tự chọn công cụ để lấy dữ liệu tài chính thật, rồi tự kiểm tra kết quả và lặp lại cho đến khi xong. Nó cũng ghi lại từng bước để bạn soát. Chatbot thường trả lời một lần, không có quy trình này. Mức độ chính xác hơn kém cụ thể thì tư liệu chưa có so sánh.

### Có dùng để đầu tư thật được không?

Không nên. README ghi rõ dự án chỉ dành cho mục đích học tập, giải trí và tham khảo, không phải lời khuyên tài chính, và kết quả có thể sai hoặc lỗi thời. Hãy hỏi chuyên gia có giấy phép trước khi quyết định đầu tư.

### Có dùng được qua điện thoại không?

Có, qua gateway WhatsApp. Bạn chạy bun run gateway:login để quét mã QR, rồi bun run gateway để bật. Sau đó nhắn cho chính mình trong WhatsApp, Dexter sẽ trả lời trong khung chat đó. Máy chạy gateway cần đang bật.
