# Horizon: radar tin tức AI tự lọc và tóm tắt mỗi ngày — hướng dẫn cài đặt và dùng

> Horizon là công cụ mã nguồn mở viết bằng Python, đóng vai radar tin tức cá nhân. Nó thu thập tin từ nhiều nguồn, nhờ AI chấm điểm, loại tin trùng rồi tạo bản tin Markdown bằng tiếng Anh và tiếng Trung. Cài bằng uv hoặc Docker khá gọn, nhưng bạn cần có API key của một nhà cung cấp AI.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-07-26 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/horizon-radar-tin-tuc-ai-ban-tin-hang-ngay-2

Horizon là một công cụ mã nguồn mở viết bằng Python, giúp bạn dựng "radar tin tức" riêng. Nó tự gom bài từ nhiều nguồn, dùng AI chấm điểm xem bài nào đáng đọc, loại tin trùng, rồi tạo một bản tin mỗi ngày bằng tiếng Anh và tiếng Trung.

Nếu bạn phải theo dõi nhiều thứ cùng lúc (tin công nghệ, blog kỹ thuật, tài chính, mạng xã hội) thì repo này dành cho bạn. Người làm kinh doanh có thể dùng nó để nắm xu hướng ngành. Lập trình viên có thể dùng nó để khỏi lướt Hacker News hay Reddit cả buổi sáng.

Điểm đáng giá nhất là khái niệm **profile**: mỗi loại nội dung có tiêu chí chấm điểm và cách viết riêng. Tin thời sự được viết theo kiểu "vì sao nó quan trọng", bài kỹ thuật thì theo kiểu "mình dùng được gì". Hiện repo có khoảng 14014 sao và 2008 fork, giấy phép MIT, và vẫn được cập nhật trong vài tháng gần đây.

```repo
- repo | Thysrael/Horizon
- kind | Ứng dụng
- desc | Horizon gom tin từ RSS, Hacker News, Reddit… rồi dùng AI chấm điểm, lọc trùng và viết bản tin song ngữ Anh–Trung mỗi ngày.
- stars | 14k
- lang | Python
- license | MIT
```

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

Dưới đây là các tính năng chính, kèm lợi ích thực tế.

- **Gom nhiều nguồn về một chỗ.** Horizon đọc được RSS/Atom, Hacker News, Reddit, Telegram (kênh công khai), Twitter/X (qua Apify), GitHub (sự kiện người dùng và bản phát hành repo), OpenBB (tin tài chính theo danh sách theo dõi), OSS Insight (repo đang thịnh hành), GDELT và Google News. Bạn không phải mở từng trang nữa.
- **AI chấm điểm và lọc.** Mỗi profile có thang điểm riêng và ngưỡng riêng. Bài dưới ngưỡng bị bỏ, bài trùng chủ đề được gộp lại. Bản tin ngắn hơn và ít lặp hơn.
- **Mỗi loại bài một cách viết.** Profile có sẵn gồm `tech-news` (sự kiện, bối cảnh, tác động), `tech-blog` (nền tảng, giải pháp, điều rút ra) và `ai-creator` (tóm tắt kèm góc khai thác nội dung). Bạn có thể chỉnh profile mà thường không phải sửa Python.
- **Thêm bối cảnh và thảo luận.** Với nguồn như Hacker News, Reddit, X, Horizon lấy cả các bình luận hàng đầu. Nó cũng bổ sung thông tin nền tìm trên web khi cần.
- **Cân bằng chủ đề.** Bạn đặt số bài tối đa và hạn mức cho từng nhóm. Nhờ vậy một chủ đề "nóng" không lấn hết chỗ của các chủ đề khác.
- **Giao bản tin nhiều kiểu.** Xuất Markdown song ngữ Anh–Trung, đăng lên GitHub Pages, gửi email cho người đăng ký, đẩy thông báo qua webhook (Feishu/Lark, DingTalk, Slack, Discord hoặc webhook tự định nghĩa) hoặc gửi qua WeChat.
- **Gọi từ trợ lý AI.** Repo có máy chủ MCP và một Agent Skill, để trợ lý AI giúp bạn cấu hình nguồn và chạy từng khâu.

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

Theo tư liệu của repo, bạn cần:

- **Python 3.11 trở lên** (`pyproject.toml` yêu cầu `>=3.11`).
- **uv** nếu cài theo cách khuyến nghị. Có thể dùng `pip` thay thế. Hoặc dùng **Docker** với `docker compose`.
- **Git** để tải mã nguồn.
- **Một tài khoản/API key của nhà cung cấp AI.** File `.env.example` có sẵn tên biến cho Anthropic, OpenAI, Azure OpenAI, Google (Gemini), MiniMax, DashScope, Doubao và DeepSeek. README cũng nói người dùng ChatGPT đủ điều kiện có thể chọn `openai-chatgpt` để đăng nhập bằng gói của mình, không cần API key OpenAI.
- **Tùy nguồn bạn dùng:** `GITHUB_TOKEN`, `APIFY_TOKEN` (cho Twitter/X), `FIRECRAWL_API_KEY`… cũng có trong `.env.example`. Nếu chỉ dùng RSS thì bạn không cần các key này.
- **Node.js 22.20 trở lên**, nhưng chỉ khi bạn muốn cài Agent Skill bằng `npx`.

Tư liệu không nói gì về yêu cầu phần cứng hay GPU. Phần nặng (mô hình ngôn ngữ) do nhà cung cấp AI bạn chọn xử lý qua API.

```note
API key là bí mật. Chỉ để trong file .env, đừng dán vào file cấu hình, đừng đẩy lên GitHub. Mỗi lần chạy, AI sẽ tính phí theo gói của nhà cung cấp, nên hãy bắt đầu với ít nguồn và khoảng thời gian ngắn để xem chi phí.
```

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

```steps
- Tải mã nguồn | git clone repo về máy rồi vào thư mục
- Cài thư viện | dùng uv sync (hoặc pip, hoặc Docker)
- Cấu hình | chạy trình hướng dẫn hoặc tự sao chép file mẫu
- Điền API key | ghi key vào file .env
- Chạy | uv run horizon để tạo bản tin đầu tiên
```

### Tải mã nguồn và cài thư viện

Mở terminal (PowerShell trên Windows, Terminal trên macOS/Linux), rồi chạy:

```bash
git clone https://github.com/Thysrael/Horizon.git
cd Horizon

# Install with uv (recommended)
uv sync

# Or with pip
pip install -e .
```

`git clone` tải repo về, `cd Horizon` đưa bạn vào thư mục vừa tải. Các lệnh sau phải chạy trong thư mục này, đây là chỗ người mới hay quên. `uv sync` cài toàn bộ thư viện cần thiết. Nếu chưa có uv, bạn dùng dòng `pip install -e .` thay thế.

Cần chạy test hoặc phát triển thêm thì dùng:

```bash
uv sync --extra dev
```

Muốn có nguồn tin tài chính OpenBB (tùy chọn):

```bash
uv sync --extra openbb
```

Nếu `openbb` kéo về gói không có bản dựng sẵn trên máy bạn, README gợi ý cài thủ công chỉ với bản nhị phân:

```bash
uv pip install --only-binary=:all: openbb openbb-benzinga
```

### Hoặc cài bằng Docker

Nếu bạn quen Docker hơn, cũng tải mã nguồn như trên:

```bash
git clone https://github.com/Thysrael/Horizon.git
cd Horizon

# Optional: build with comma-separated extras before the first run
docker compose build --build-arg EXTRAS=openbb horizon
```

Dòng `docker compose build` là tùy chọn, chỉ cần khi bạn muốn thêm extra như `openbb`. README lưu ý extra `twitter` cần thêm trình duyệt Playwright và các gói hệ thống mà Dockerfile hiện tại chưa cài.

### Cấu hình bằng trình hướng dẫn (khuyến nghị)

```bash
uv run horizon-wizard
```

Trình này hỏi bạn quan tâm chủ đề gì (ví dụ "LLM inference", "web security") rồi tự tạo file `data/config.json`. Đây là cách dễ nhất cho người mới.

### Hoặc cấu hình thủ công

```bash
cp .env.example .env          # Add your API keys
cp data/config.example.json data/config.json  # Customize your sources
```

Lệnh `cp` có sẵn trong Terminal macOS/Linux. Trên Windows PowerShell, bạn có thể dùng `Copy-Item` với cùng hai đường dẫn, hoặc chạy bằng Git Bash. Sau đó mở `.env` điền key thật. Ví dụ với OpenAI:

```bash
OPENAI_API_KEY=sk-your-key
```

File `data/config.json` tối thiểu theo README trông như sau:

```json
{
  "ai": {
    "provider": "openai",
    "model": "gpt-4",
    "api_key_env": "OPENAI_API_KEY"
  },
  "sources": {
    "rss": [
      {
        "name": "Simon Willison",
        "url": "https://simonwillison.net/atom/everything/",
        "profile": "tech-news"
      }
    ]
  },
  "processing": {
    "profiles_dir": "profiles",
    "default_profile": "tech-news",
    "profile_settings": {
      "tech-news": {
        "threshold": 7.0,
        "topic_dedup": true
      }
    }
  }
}
```

Chỗ dễ vấp nhất: `api_key_env` là **tên** biến môi trường (ở đây là `OPENAI_API_KEY`), không phải chính cái key. Key thật nằm trong `.env`. Nếu muốn dùng Gemini, README ghi cấu hình như sau:

```json
{
  "ai": {
    "provider": "gemini",
    "model": "gemini-2.0-flash",
    "api_key_env": "GOOGLE_API_KEY"
  }
}
```

Một số điều nên biết về cấu hình:

- Nếu nguồn có `profile` cụ thể thì Horizon dùng đúng profile đó. Bỏ trống hoặc đặt `"auto"` thì AI tự chọn profile phù hợp. Đặt thành danh sách thì AI chỉ chọn trong các profile ấy.
- Ngưỡng điểm và việc gộp chủ đề trùng nằm trong `processing.profile_settings`, không nằm trong file profile.
- Mọi giá trị chuỗi trong `data/config.json` có thể tham chiếu biến môi trường dạng `${VAR_NAME}`, tiện cho URL webhook hay RSS riêng tư.
- Muốn giới hạn độ dài bản tin, README có khối `digest` với `max_items` và `category_groups`. Chi tiết xem Configuration Guide trong tài liệu của dự án.

### Chạy lần đầu

Bản cài trên máy:

```bash
uv run horizon [OPTIONS]
```

Bản Docker:

```bash
docker compose run --rm horizon [OPTIONS]
```

Các tùy chọn chính theo README: `--hours N` (lấy tin trong N giờ gần nhất, mặc định 24), `-d`/`--data-dir PATH` (thư mục dữ liệu, mặc định `data`), `-c`/`--config PATH` (đường dẫn file cấu hình) và `-l`/`--log-level LEVEL` (mức log, mặc định `WARNING`).

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

Sau khi chạy `uv run horizon`, bản tin được lưu trong thư mục `data/summaries/` (hoặc `<data-dir>/summaries/` nếu bạn đổi thư mục dữ liệu). Mở file Markdown ở đó: nếu thấy danh sách bài đã xếp hạng, có tóm tắt và bối cảnh, tức là cài thành công.

Để xem rõ quá trình chạy, hãy thêm mức log chi tiết:

```bash
uv run horizon --hours 24 --log-level INFO
```

Nếu thư mục `summaries` rỗng, rất có thể mọi bài đều dưới ngưỡng điểm, hoặc key AI chưa đúng. Phần lỗi thường gặp bên dưới sẽ chỉ cách kiểm tra.

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

### Chủ shop theo dõi xu hướng ngành mỗi sáng

Bạn bán hàng online và muốn biết đối thủ, nền tảng thương mại điện tử có động thái gì. Bạn thêm vài nguồn RSS hoặc Google News theo từ khóa vào `data/config.json`, đặt `default_profile` là `tech-news`, rồi chạy:

```bash
uv run horizon --hours 24
```

Kết quả là một file Markdown gom các tin đáng chú ý trong 24 giờ, mỗi tin có tóm tắt và bối cảnh. Bạn đọc trong năm phút thay vì lướt cả chục trang.

> Đọc tin giỏi không phải là đọc nhiều hơn, mà là chỉ đọc đúng thứ đáng đọc.
>
> — Ông T

### Lập trình viên mới theo dõi blog kỹ thuật

Bạn muốn học từ các bài blog engineering nhưng không có thời gian đọc hết. Gắn các nguồn RSS blog vào profile `tech-blog`. Profile này viết bản tin theo kiểu nền tảng, giải pháp và điều rút ra được. Thêm `"threshold": 7.0` để chỉ giữ bài điểm cao. Mỗi sáng bạn nhận vài bài đã được rút gọn thành "vấn đề gì, giải quyết thế nào, mình học được gì".

### Nhân viên văn phòng nhận tin qua kênh nhóm

Cả nhóm dùng Slack hoặc Discord. README nói Horizon có thể đẩy kết quả qua webhook tới Feishu/Lark, DingTalk, Slack, Discord hoặc endpoint tùy chỉnh. Bạn khai báo địa chỉ webhook (biến `HORIZON_WEBHOOK_URL` có trong `.env.example`) rồi xem Configuration Guide để biết chỗ khai trong cấu hình. Khi chạy xong, nhóm nhận thông báo kết quả ngay trong kênh chat. Lưu ý: README mô tả webhook là nơi đẩy thông báo thành công hoặc thất bại, nên hãy thử trước với một kênh thử.

### Chạy tự động mỗi ngày

Bạn không muốn nhớ gõ lệnh. README cho biết có mẫu workflow GitHub Actions để chạy hằng ngày: mẫu này đang bị tắt trong repo gốc, bạn cấu hình cho bản của mình rồi đổi tên thành `daily-summary.yml` để bật. Kết hợp với GitHub Pages, bạn có luôn một trang bản tin cập nhật mỗi ngày. Tư liệu chưa đi sâu từng bước phần này, nên hãy đọc tài liệu cấu hình trước khi làm.

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

**Lỗi key hoặc xác thực.** Dấu hiệu là log báo không xác thực được hoặc thiếu key. Kiểm tra `.env` có đúng tên biến, không thừa khoảng trắng, và `api_key_env` trong `config.json` trùng với tên biến đó. Nhắc lại: `api_key_env` là tên biến, không phải key.

**Bản tin trống hoặc rất ít bài.** Thường do ngưỡng `threshold` quá cao hoặc khoảng thời gian `--hours` quá ngắn. Thử hạ ngưỡng, tăng `--hours`, và chạy với `--log-level INFO` để xem Horizon đã lấy được bao nhiêu bài.

**Lệnh `uv` hoặc `cp` không nhận ra.** Máy bạn chưa cài uv, hoặc bạn đang ở PowerShell nên không có `cp` kiểu Linux (thực tế PowerShell có alias `cp` cho `Copy-Item`, nhưng cách viết chú thích sau lệnh trong README thì không chạy được, hãy bỏ phần chú thích). Cách khắc phục: cài uv hoặc dùng `pip install -e .`. Đảm bảo bạn đang đứng trong thư mục `Horizon`.

**Cài `openbb` thất bại.** Một số máy kéo về gói không có bản dựng sẵn. Dùng lệnh `uv pip install --only-binary=:all: openbb openbb-benzinga` như README gợi ý.

**Nguồn Twitter/X không chạy.** Nguồn này cần `APIFY_TOKEN`, và extra `twitter` cần trình duyệt Playwright cùng gói hệ thống, mà Dockerfile hiện tại không cài. Nếu dùng Docker, hãy bắt đầu với các nguồn khác như RSS hoặc Hacker News.

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

Điểm mạnh: nhiều loại nguồn, hệ thống profile linh hoạt, cân bằng chủ đề, giao bản tin qua nhiều kênh, có trình hướng dẫn cấu hình, hỗ trợ Docker và MCP. Giấy phép MIT, cộng đồng đông, repo còn được cập nhật.

Giới hạn: bạn vẫn phải có API key của một nhà cung cấp AI nên có chi phí tùy nơi bạn chọn. Bản tin mặc định là tiếng Anh và tiếng Trung, tư liệu không nhắc việc tạo bản tiếng Việt. Một số kênh (Twitter/X, WeChat, email) cần thêm cấu hình. Gói chưa có trên PyPI, nên chưa thể `pip install` trực tiếp từ đó (README ghi đây là việc dự kiến).

Nếu bạn chỉ muốn đọc vài trang tin quen thuộc, một trình đọc RSS thông thường đã đủ và đơn giản hơn. Còn nếu bạn theo dõi nhiều nguồn, muốn có chấm điểm, bối cảnh và bản tin tự động mỗi ngày, Horizon là lựa chọn đáng thử.

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

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

Mã nguồn Horizon dùng giấy phép MIT nên bạn dùng miễn phí. Tuy nhiên bạn cần API key của một nhà cung cấp AI, và phí tính theo gói của nhà cung cấp đó. Tư liệu không nêu mức phí cụ thể.

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

Tư liệu không yêu cầu GPU. Phần phân tích do mô hình AI của nhà cung cấp bạn chọn xử lý qua API, nên máy của bạn chỉ cần chạy được Python 3.11 trở lên hoặc Docker.

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

README không nêu riêng về hệ điều hành. Công cụ viết bằng Python và có hỗ trợ Docker, nên về nguyên tắc bạn có thể chạy trên Windows. Một số lệnh mẫu như cp viết kiểu Linux, bạn cần đổi sang lệnh tương đương trong PowerShell.

### Cần những API key nào?

Bạn cần ít nhất một key của nhà cung cấp AI, ví dụ OpenAI, Anthropic, Google, DeepSeek… Tên biến có trong file .env.example. Nguồn tin như Twitter/X cần thêm APIFY_TOKEN. Người dùng ChatGPT đủ điều kiện có thể chọn openai-chatgpt để không cần key OpenAI.

### Horizon khác gì một trình đọc RSS thông thường?

Trình đọc RSS chỉ hiển thị bài mới. Horizon còn gom nhiều loại nguồn, dùng AI chấm điểm, lọc tin trùng, thêm bối cảnh và bình luận, rồi viết bản tin theo profile bạn chọn.

### Bản tin có tiếng Việt không?

README nói Horizon tạo bản tin bằng tiếng Anh và tiếng Trung. Tư liệu chưa nhắc tới tiếng Việt, nên bạn cần xem tài liệu cấu hình hoặc tự chỉnh profile nếu muốn.

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

Cấu hình và bản tin được lưu trong thư mục data trên máy bạn. Nội dung bài viết sẽ được gửi tới nhà cung cấp AI bạn chọn để xử lý. Tư liệu không có thêm thông tin chi tiết về chính sách dữ liệu, hãy xem điều khoản của nhà cung cấp đó.
