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
Bài này là một góc nhìn khác về Thysrael/Horizon — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: 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 →

Tóm tắt nhanh
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.
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.
Thysrael/Horizon
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.
I.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.
II.Cần chuẩn bị gì
Theo tư liệu của repo, bạn cần:
- Python 3.11 trở lên (
pyproject.tomlyêu cầu>=3.11). - uv nếu cài theo cách khuyến nghị. Có thể dùng
pipthay thế. Hoặc dùng Docker vớidocker compose. - Git để tải mã nguồn.
- Một tài khoản/API key của nhà cung cấp AI. File
.env.examplecó 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ọnopenai-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.
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í.
III.Cài đặt từng bước
- Tải mã nguồngit clone repo về máy rồi vào thư mục
- Cài thư việndùng uv sync (hoặc pip, hoặc Docker)
- Cấu hìnhchạy trình hướng dẫn hoặc tự sao chép file mẫu
- Điền API keyghi key vào file .env
- Chạyuv run horizon để tạo bản tin đầu tiên
A.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:
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:
uv sync --extra devMuốn có nguồn tin tài chính OpenBB (tùy chọn):
uv sync --extra openbbNế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:
uv pip install --only-binary=:all: openbb openbb-benzingaB.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:
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 horizonDò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.Cấu hình bằng trình hướng dẫn (khuyến nghị)
uv run horizon-wizardTrì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.
D.Hoặc cấu hình thủ công
cp .env.example .env # Add your API keys
cp data/config.example.json data/config.json # Customize your sourcesLệ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:
OPENAI_API_KEY=sk-your-keyFile data/config.json tối thiểu theo README trông như sau:
{
"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:
{
"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ó
profilecụ 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.jsoncó 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
digestvớimax_itemsvàcategory_groups. Chi tiết xem Configuration Guide trong tài liệu của dự án.
E.Chạy lần đầu
Bản cài trên máy:
uv run horizon [OPTIONS]Bản Docker:
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).
IV.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:
uv run horizon --hours 24 --log-level INFONế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.
V.Dùng vào việc thật
A.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:
uv run horizon --hours 24Kế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
B.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ì".
C.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ử.
D.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.
VI.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.
VII.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 đó.


