worldmonitor: bảng điều khiển tin tức và tình hình thế giới — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về koala73/worldmonitor — 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: worldmonitor: bảng điều khiển tin tức và địa chính trị thời gian thực — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
World Monitor (koala73/worldmonitor) là bảng điều khiển mã nguồn mở, gom tin tức toàn cầu, bản đồ 3D, thị trường tài chính và các chỉ số rủi ro địa chính trị vào một giao diện. Bạn có thể dùng bản web có sẵn, chạy thử trong terminal bằng npx hoặc tự dựng bằng Docker. Cài bản terminal chỉ cần một lệnh, tự dựng cả hệ thống thì cần thêm Docker hoặc Node.js 24.
World Monitor là một bảng điều khiển «nhìn toàn cảnh thế giới» theo thời gian thực. Nó gom tin tức từ nhiều nguồn, bản đồ, giá thị trường, xung đột, chuyến bay quân sự, an ninh mạng, khí hậu vào cùng một màn hình. Tin tức còn được AI tóm tắt thành bản tin ngắn. Repo này là mã nguồn của chính trang worldmonitor.app, viết chủ yếu bằng TypeScript, hiện có khoảng 90.557 sao và 14.047 fork trên GitHub.
Nếu bạn làm kinh doanh xuất nhập khẩu, đầu tư, logistics, năng lượng, hoặc đơn giản là hay phải theo dõi tin quốc tế để ra quyết định, công cụ này giúp bạn khỏi mở hàng chục tab. Lập trình viên cũng dùng được: repo có CLI, SDK (Python, Ruby, Go), REST API và cả MCP server để cho các trợ lý AI gọi dữ liệu.
Điểm đáng giá nhất là bạn có nhiều đường vào, từ dễ đến khó. Dễ nhất là mở web. Tiếp theo là chạy npx worldmonitor để xem bảng điều khiển ngay trong terminal, không cần API key. Muốn tự làm chủ thì có script cài một dòng bằng Docker. Bài này đi qua từng cách.
koala73/worldmonitor
World Monitor là bảng điều khiển thời gian thực gom tin tức, bản đồ, thị trường và rủi ro địa chính trị vào một màn hình; chạy web, terminal, Docker hoặc MCP.
I.World Monitor làm được gì
README liệt kê khá nhiều tính năng. Mình chọn những ý có ích nhất cho người dùng thường:
- Tin tức tuyển chọn, AI tóm tắt. Tin được chia theo nhóm toàn cầu và khu vực, rồi tổng hợp thành bản tin ngắn. Bạn đọc nhanh hơn thay vì lướt từng trang.
- Hai kiểu bản đồ. Có quả địa cầu 3D (globe.gl) và bản đồ phẳng WebGL (deck.gl), dùng chung một danh mục lớp dữ liệu. Bạn bật hoặc tắt lớp nào cần xem.
- Tương quan chéo giữa các luồng tín hiệu. Công cụ đối chiếu tín hiệu quân sự, kinh tế, thiên tai và leo thang căng thẳng để thấy chỗ nào đang «nóng» cùng lúc.
- Chỉ số bất ổn quốc gia (CII). README mô tả điểm số, mức độ và biến động xấp xỉ 24 giờ cho 31 quốc gia nhóm Tier-1. Đây là cách nhìn nhanh về rủi ro.
- Radar tài chính. Sàn chứng khoán, hàng hoá, tiền số và một chỉ số tổng hợp thị trường.
- AI chạy cục bộ. README nói bạn có thể chạy toàn bộ với Ollama, không cần API key.
- Nhiều biến thể từ một mã nguồn. Gồm world, tech, finance, commodity, happy và energy. Bạn chọn bản hợp ngành mình.
- Ứng dụng desktop (Tauri 2) cho Windows, macOS và Linux, cùng giao diện đa ngôn ngữ có hỗ trợ chữ viết từ phải sang trái.
Hiểu đơn giản: đây là phòng theo dõi tình hình thu nhỏ, và bạn không phải tự đi gom từng nguồn.
II.Cần chuẩn bị gì
Tuỳ cách dùng, yêu cầu khác nhau. Mình tách theo từng đường để bạn khỏi chuẩn bị thừa.
- Dùng bản web: chỉ cần trình duyệt. README chưa nói yêu cầu cấu hình riêng.
- Bảng điều khiển trong terminal (
npx worldmonitor): cần có Node.js và npm để chạynpx. README ghi rõ không cần API key. README không nêu phiên bản Node riêng cho gói này. - Tự dựng bằng Docker (script một dòng): cần có Docker, vì script dựng cả dashboard, Redis, AIS relay và dữ liệu công khai đã nạp sẵn. API key là tuỳ chọn.
- Chạy để phát triển (hot-reload): cần Node.js 24, đúng phiên bản ghi trong file
.nvmrc. README cảnh báo các gói của hệ điều hành thường cũ hơn. Debian 12 và Raspberry Pi OS đi kèm Node.js 18, và khi đónpm installsẽ dừng với lỗiInvalid comparator: file:vendor/braces. Bạn có thể cài Node 24 bằng nvm hoặc tải từ nodejs.org. Cần thêm Git để tải mã nguồn. - API key: ứng dụng chạy được mà không cần biến môi trường nào. Một số nguồn dữ liệu riêng cần khoá, ví dụ file
.env.examplecó các biến nhưOPENROUTER_API_KEY,FINNHUB_API_KEY,FRED_API_KEY,EIA_API_KEY. Bạn chỉ cần điền khi muốn dùng đúng tính năng đó. - Gọi MCP server hoặc CLI có xác thực: cần khoá API. README nói có thể lấy tại trang worldmonitor.app/pro.
README không nói gì về yêu cầu GPU hay RAM tối thiểu, nên mình không đưa ra con số nào.
III.Cài đặt từng bước
- Chọn cách dùngWeb, terminal, Docker hoặc chạy dev, tuỳ nhu cầu
- Thử nhanh bằng npxChạy bảng điều khiển trong terminal, không cần key
- Tự dựng bằng DockerMột dòng lệnh cài cả hệ thống
- Hoặc chạy bản devClone repo, npm install, npm run dev
- Chọn biến thểChạy bản tech, finance, commodity, happy hoặc energy
A.Chọn cách dùng phù hợp
Nếu chỉ muốn xem, bạn mở worldmonitor.app là xong, không cần cài gì. Các bước dưới đây dành cho ai muốn chạy trên máy mình. Người mới nên thử bước terminal trước vì nó nhẹ nhất.
B.Thử nhanh bảng điều khiển trong terminal
Mở terminal (Windows: PowerShell hoặc Windows Terminal; macOS/Linux: Terminal) rồi gõ:
npx worldmonitorChạy không kèm tham số trong terminal sẽ mở bảng điều khiển với bản đồ thế giới, tin tức, thị trường, xung đột, chuyến bay quân sự, an ninh mạng, khí hậu, thị trường dự đoán và truyền hình trực tiếp. README nói có hỗ trợ chuột và nhiều giao diện màu, và không cần API key.
Bạn cũng có thể cài thành lệnh dùng lâu dài. README ghi hai cách:
npm install -g worldmonitor
brew install worldmonitorLệnh đầu dùng npm, lệnh sau dùng Homebrew (macOS/Linux). Chọn một trong hai. Sau khi cài, README cho biết có lệnh worldmonitor và bí danh ngắn wm.
C.Tự dựng cả hệ thống bằng Docker
Đây là cách cài một dòng mà README gọi là «One-line install». Bạn cần Docker đã chạy sẵn, rồi gõ:
curl -fsSL https://www.worldmonitor.app/install.sh | bashTheo README, script này sẽ:
- Tải mã nguồn về thư mục
./worldmonitor(hoặc dùng lại bản bạn đã clone). - Tạo các khoá bí mật cần thiết.
- Khởi động cả hệ thống và nạp dữ liệu.
Xong thì mở http://localhost:3000. README nói có các tuỳ chọn --dir, --port, --no-seed, --no-build, đặt sau bash -s --, và bạn có thể xem thêm bằng scripts/install.sh --help. Chi tiết chạy thật, gỡ cài đặt nằm trong file SELF_HOSTING.md của repo.
Trên Windows, lệnh curl ... | bash cần môi trường có bash, ví dụ Git Bash hoặc WSL. README không hướng dẫn riêng cho PowerShell, nên bạn xem SELF_HOSTING.md nếu vướng.
Lệnh curl ... | bash chạy thẳng một script tải từ mạng. Trước khi chạy, bạn nên mở địa chỉ script trong trình duyệt đọc qua, hoặc dùng cách clone repo bên dưới rồi đọc scripts/install.sh. Đừng chạy trên máy chứa dữ liệu quan trọng nếu chưa hiểu nó làm gì.
D.Hoặc chạy bản phát triển (hot-reload)
Cách này hợp với người muốn xem hoặc sửa mã. Trước hết kiểm tra Node.js bằng node -v; cần bản 24. Sau đó:
git clone https://github.com/koala73/worldmonitor.git
cd worldmonitor
npm install
npm run devGiải thích:
git clonetải mã nguồn về máy.cd worldmonitorđi vào thư mục vừa tải. Nhiều người quên bước này rồi chạynpm installở sai chỗ.npm installcài thư viện phụ thuộc, có thể mất vài phút.npm run devbật máy chủ phát triển.
Mở http://localhost:3000. Muốn đổi cổng, README nói đặt DEV_PORT trong file .env.local. Ứng dụng chạy được khi không có biến môi trường nào.
E.Chọn biến thể theo ngành
Mỗi biến thể có một lệnh riêng, chạy trong cùng thư mục repo:
npm run dev:tech # tech.worldmonitor.app
npm run dev:finance # finance.worldmonitor.app
npm run dev:commodity # commodity.worldmonitor.app
npm run dev:happy # happy.worldmonitor.app
npm run dev:energy # energy.worldmonitor.appBản happy là một biến thể riêng của dự án. README không mô tả kỹ nội dung của nó, nên bạn thử để biết.
IV.Kiểm tra đã chạy được chưa
Tuỳ cách cài, bạn kiểm tra như sau:
- Bản Docker hoặc bản dev: mở http://localhost:3000. Nếu thấy giao diện bảng điều khiển với bản đồ và các panel là thành công. Nếu dùng
--port, hoặcDEV_PORTđể đổi cổng, hãy mở đúng cổng đó. - Bản terminal: chạy
npx worldmonitorthấy bảng điều khiển hiện lên trong terminal là xong. - Kiểm tra CLI: README đưa một lệnh liệt kê mọi công cụ MCP, không cần key:
npx worldmonitor toolsNếu lệnh trả về danh sách công cụ, nghĩa là Node, npm và kết nối mạng của bạn đều ổn.
Với bản dev, bạn còn có thể kiểm tra mã bằng hai lệnh README ghi ở phần đóng góp:
npm run typecheck
npm run build:fullLệnh đầu kiểm tra kiểu dữ liệu, lệnh sau dựng bản production. Người chỉ dùng thì không cần chạy hai lệnh này.
V.Dùng vào việc thật
A.Chủ doanh nghiệp xuất nhập khẩu theo dõi hàng hoá
Bạn nhập nông sản hoặc xuất hàng đi nước ngoài, giá cả và tin địa chính trị ảnh hưởng thẳng vào đơn hàng. Thay vì mở nhiều trang, bạn chạy biến thể hàng hoá:
npm run dev:commodityMở http://localhost:3000, bạn có giá hàng hoá cạnh tin tức và bản đồ. Mỗi sáng bạn lướt một màn hình để nắm khu vực nào đang có biến động. Kết quả là bạn có một chỗ duy nhất để nhìn tình hình trước khi họp hoặc chốt đơn.
Đừng cố đọc hết tin thế giới. Hãy để một màn hình nhặt ra chỗ nào đang nóng.
Ông T
B.Nhân viên văn phòng muốn xem tình hình nhanh, không cài phức tạp
Bạn không rành kỹ thuật, chỉ cần nắm tin trong ngày. Bạn mở worldmonitor.app trên trình duyệt. Muốn thử bản terminal thì chạy:
npx worldmonitorBạn dùng chuột để chọn panel, đổi giao diện màu theo ý thích. Kết quả: vài phút là có cái nhìn tổng quan về tin tức, thị trường và xung đột, không cần tài khoản hay key.
C.Lập trình viên tra rủi ro quốc gia từ dòng lệnh
Bạn đang viết một báo cáo hoặc công cụ nội bộ và cần dữ liệu rủi ro theo quốc gia. Sau khi cài CLI bằng npm install -g worldmonitor, README đưa ví dụ:
worldmonitor risk IR --api-key wm_xxxIR là mã quốc gia trong ví dụ của README, wm_xxx là chỗ bạn thay bằng khoá API của mình. Kết quả là dữ liệu rủi ro in ngay trong terminal, tiện để ghép vào script. Nếu bạn dùng Python, README nói có gói worldmonitor-sdk; Ruby và Go cũng có SDK tương ứng. Cách gọi chi tiết xem tài liệu SDK của dự án vì README chưa ghi.
D.Dev cho trợ lý AI đọc dữ liệu qua MCP
Bạn dùng một trợ lý AI hỗ trợ MCP và muốn nó tự tra tin tức, rủi ro. README ghi địa chỉ MCP server là https://worldmonitor.app/mcp (Streamable HTTP). Việc xem danh sách công cụ (tools/list) là công khai. Còn gọi công cụ (tools/call) cần khoá API qua header X-WorldMonitor-Key hoặc đăng nhập OAuth. Kết quả là trợ lý của bạn có thể lấy dữ liệu từ World Monitor thay vì bạn tự copy tay. Cách khai báo MCP trong từng ứng dụng khác nhau, README chưa ghi, bạn xem trang MCP Overview của dự án.
VI.Lỗi hay gặp và cách xử lý
A.npm install báo Invalid comparator: file:vendor/braces
Đây là lỗi chính README nhắc tới. Nguyên nhân là Node.js quá cũ (Debian 12 và Raspberry Pi OS đi kèm Node 18). Cách xử lý: cài Node.js 24 bằng nvm, vào thư mục repo rồi chạy nvm install để nó đọc .nvmrc, hoặc tải bản Node.js từ nodejs.org. Sau đó chạy lại npm install.
B.Mở localhost:3000 không thấy gì
Thường do chưa chạy xong, cổng đã bị chương trình khác dùng, hoặc bạn đã đổi cổng. Hãy xem terminal còn đang chạy không và có báo lỗi không. Với bản dev, bạn đặt DEV_PORT trong .env.local để đổi cổng; với script Docker thì dùng tuỳ chọn --port.
C.Một số panel trống hoặc thiếu dữ liệu
README nói một số nguồn dữ liệu cần thông tin đăng nhập riêng. Bạn mở file .env.example, tìm biến tương ứng (ví dụ FINNHUB_API_KEY cho dữ liệu thị trường) rồi điền khoá của mình. Đừng đưa khoá vào mã nguồn hay đẩy lên GitHub.
D.Lệnh curl ... | bash không chạy trên Windows
PowerShell thường không chạy được dòng lệnh kiểu bash này. Hãy dùng Git Bash hoặc WSL, hoặc chọn cách clone repo rồi npm run dev. Nếu cần chạy Docker bằng tay, xem SELF_HOSTING.md.
E.Gọi MCP hoặc CLI bị từ chối
Xem công cụ thì được, nhưng gọi công cụ cần khoá. Hãy kiểm tra bạn đã có khoá API (lấy ở worldmonitor.app/pro theo README) và truyền đúng header X-WorldMonitor-Key, hoặc đúng cờ --api-key với CLI. Đừng dán khoá vào chỗ công khai.
VII.Có nên dùng không
Điểm mạnh. Có nhiều đường vào: web, terminal, desktop, Docker, CLI, SDK, MCP. Bản terminal cài dễ và không cần key. Dự án còn được cập nhật trong 3 tháng gần đây, README có bảng nêu rõ bề mặt nào đang ổn định, và có sẵn biến thể theo ngành. Chạy AI cục bộ bằng Ollama cũng là điểm cộng nếu bạn lo dữ liệu.
Giới hạn. Muốn tự dựng đầy đủ thì phải biết dùng Docker hoặc Node.js 24, không hẳn nhẹ nhàng với người mới. Một số nguồn dữ liệu cần khóa riêng, và gọi MCP/CLI cần khoá API. Chỉ số như CII là mô hình tính của dự án; bạn nên coi là tham khảo, không phải kết luận cuối cùng khi ra quyết định lớn. README cũng không nói rõ mức tài nguyên máy cần cho bản tự dựng.
Giấy phép. Mã nguồn dùng AGPL-3.0-only. README nói tự dựng, dùng cá nhân hay nghiên cứu đều được. Dùng thương mại hoặc làm dịch vụ cũng được nếu bạn tuân thủ các nghĩa vụ của AGPL, như chia sẻ mã nguồn khi cần. Muốn dùng mã kín hoặc dùng thương hiệu chính thức thì cần xin phép riêng. Nếu định làm sản phẩm bán ra, bạn nên đọc kỹ LICENSE.
Khi nào chọn cách khác. Nếu chỉ cần đọc tin thuần tuý, một trình đọc RSS đơn giản là đủ. Nếu cần dữ liệu có cam kết dịch vụ ở mức doanh nghiệp, hãy hỏi trực tiếp tác giả về giấy phép thương mại thay vì tự dựng. Còn nếu bạn muốn một bức tranh tổng thể về tin tức, thị trường và rủi ro trong cùng một nơi, World Monitor rất đáng thử, và cách npx worldmonitor gần như không tốn gì.
Câu hỏi thường gặp
World Monitor có miễn phí không?
Mã nguồn dùng giấy phép AGPL-3.0-only, bạn có thể tự cài và chạy. Bảng điều khiển terminal ghi rõ không cần API key. Một số tính năng như gọi MCP có xác thực cần khoá API, README chưa nêu giá cụ thể.
Cần GPU hoặc máy mạnh không?
README không nêu yêu cầu GPU hay cấu hình phần cứng tối thiểu. Có nhắc tới việc chạy AI cục bộ bằng Ollama, nhưng không nói rõ máy cần mạnh cỡ nào, nên hiện chưa có thông tin chính xác.
Chạy được trên Windows không?
Có. README nói có bản desktop (Tauri) cho Windows, macOS và Linux, và bảng điều khiển terminal chạy bằng npx. Lệnh cài một dòng dùng bash nên trên Windows bạn cần Git Bash hoặc WSL.
Cần phiên bản Node.js nào để chạy từ mã nguồn?
Cần Node.js 24, đúng phiên bản ghi trong file .nvmrc. Node cũ hơn (ví dụ bản 18 trên Debian 12) có thể làm npm install báo lỗi Invalid comparator. Bạn có thể cài Node 24 bằng nvm hoặc từ nodejs.org.
Có bắt buộc phải có API key không?
Không. README nói ứng dụng chạy được mà không cần biến môi trường nào, và các khoá trong .env.example là tuỳ chọn cho từng nguồn dữ liệu. Riêng việc gọi công cụ MCP hoặc dùng CLI có xác thực thì cần khoá.
Có dùng với trợ lý AI được không?
Được. Dự án có MCP server tại địa chỉ https://worldmonitor.app/mcp, có CLI, REST API và SDK cho Python, Ruby, Go. Xem danh sách công cụ là công khai, còn gọi công cụ cần khoá API hoặc OAuth.
Dữ liệu của mình có an toàn không?
README không nêu chi tiết về quyền riêng tư của bản web. Nếu bạn lo ngại, có thể tự dựng trên máy mình và chạy AI cục bộ bằng Ollama như README mô tả. Repo cũng có file SECURITY.md hướng dẫn báo cáo lỗ hổng.


