worldmonitor: theo dõi tin tức, địa chính trị thời gian thực — 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
worldmonitor (World Monitor) là bảng điều khiển tình báo toàn cầu theo thời gian thực: gom tin tức, bản đồ, thị trường, xung đột, hàng không, an ninh mạng vào một giao diện, có AI tóm tắt. Bạn có thể dùng bản web có sẵn, chạy thử bằng một lệnh npx, hoặc tự dựng bằng Docker. Cài bản terminal rất dễ, tự dựng toàn bộ hệ thống thì cần quen Docker hơn.
worldmonitor là một bảng điều khiển (dashboard) mã nguồn mở, gom tin tức, bản đồ, thị trường tài chính và các tín hiệu địa chính trị trên thế giới vào một màn hình duy nhất, cập nhật theo thời gian thực. Tác giả gọi đây là giao diện "nắm bắt tình hình" (situational awareness), có AI hỗ trợ tóm tắt tin.
Nếu công việc của bạn phụ thuộc vào việc theo dõi thế giới, repo này đáng thử. Ví dụ bạn làm xuất nhập khẩu, đầu tư, phân tích rủi ro, nghiên cứu thị trường hoặc chỉ thích đọc tin có hệ thống. Thay vì mở hàng chục tab báo, tab bản đồ và tab giá hàng hoá, bạn xem một chỗ.
Điểm đáng giá nhất là repo cho bạn nhiều cách vào cửa. Bạn có thể dùng bản web, bản desktop, chạy bảng điều khiển ngay trong terminal bằng một lệnh npx, hoặc tự dựng cả hệ thống trên máy mình. Repo hiện có khoảng 90.557 sao và 14.047 fork trên GitHub, giấy phép AGPL-3.0, và vẫn được cập nhật trong 3 tháng gần đây.
koala73/worldmonitor
worldmonitor là bảng điều khiển mã nguồn mở gom tin tức, bản đồ, thị trường và tình hình địa chính trị toàn cầu vào một màn hình, theo thời gian thực.
I.worldmonitor làm được gì
Bạn không cần dùng hết. Đây là những phần hữu ích nhất với người mới:
- Tin tức tuyển chọn, có AI tóm tắt. Repo gom nhiều nguồn tin toàn cầu và theo khu vực, rồi dùng AI tổng hợp thành bản tóm tắt ngắn. Bạn đỡ phải đọc từng bài.
- Hai kiểu bản đồ. Có quả địa cầu 3D và bản đồ phẳng WebGL, dùng chung danh mục lớp dữ liệu. Bạn bật hoặc tắt từng lớp để xem thứ mình quan tâm.
- Đối chiếu tín hiệu giữa nhiều luồng. Tín hiệu quân sự, kinh tế, thiên tai và leo thang căng thẳng được đặt cạnh nhau. Nhờ vậy bạn thấy khi nhiều dấu hiệu cùng dồn về một điểm nóng.
- Chỉ số bất ổn quốc gia (CII). Đây là điểm số trực tiếp kèm mức xếp hạng và biến động xấp xỉ 24 giờ cho 31 quốc gia nhóm Tier-1. Rất tiện để liếc nhanh xem nước nào đang nóng lên.
- Radar tài chính. Có sàn chứng khoán, hàng hoá, tiền mã hoá 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 mọi thứ với Ollama mà không cần API key.
- Nhiều biến thể từ một mã nguồn. Gồm bản world, tech, finance, commodity, happy và energy. Bạn chọn bản hợp ngành mình.
- Ứng dụng desktop. Bản Tauri 2 cho Windows, macOS và Linux.
- Giao diện đa ngôn ngữ. Có nguồn tin bằng tiếng bản địa và hỗ trợ chữ viết từ phải sang trái.
- Dành cho cả AI agent và script. Repo có máy chủ MCP, REST API, công cụ dòng lệnh (CLI) và SDK cho Python, Ruby, Go.
II.Cần chuẩn bị gì
Tuỳ cách dùng, yêu cầu khác nhau. Chỉ nói những gì README ghi:
- Chỉ muốn xem: không cần cài gì, mở trang worldmonitor.app trên trình duyệt. Bản desktop cũng có cho Windows, macOS và Linux.
- Bảng điều khiển trong terminal: chạy bằng
npx worldmonitor, README ghi rõ không cần API key. Vì dùngnpxnên máy bạn cần có Node.js và npm. README không nêu phiên bản tối thiểu cho gói CLI này. - Tự dựng bằng Docker (cài một dòng): cần Docker. Lệnh này dựng cả bảng điều khiển, Redis, AIS relay và dữ liệu công khai. API key là tuỳ chọn.
- Chạy phát triển trên máy (hot-reload): cần Node.js 24, phiên bản được ghi cố định trong file
.nvmrc. README cảnh báo các gói Node trong bản phân phối Linux thường cũ. Debian 12 và Raspberry Pi OS đi kèm Node.js 18 và npm 9.2.0, khiếnnpm installdừng với lỗiInvalid comparator: file:vendor/braces. - API key: ứng dụng chạy được khi không có biến môi trường nào. Một số nguồn dữ liệu riêng lẻ mới cần khoá. File
.env.exampleliệt kê các biến nhưOPENROUTER_API_KEY,FINNHUB_API_KEY,FRED_API_KEY,EIA_API_KEY… - Dùng máy chủ MCP hoặc CLI có xác thực: cần một API key của World Monitor, gửi qua header
X-WorldMonitor-Keyhoặc--api-key. README chỉ trang worldmonitor.app/pro để lấy khoá. Chưa có thông tin về giá hay điều kiện ở tư liệu mình có.
README không nêu yêu cầu phần cứng như GPU hay dung lượng RAM tối thiểu.
III.Cài đặt từng bước
- Chọn cách dùngQuyết định: chạy thử bằng npx, tự dựng bằng Docker, hay chạy chế độ phát triển
- Thử nhanh bằng npxMở bảng điều khiển trong terminal, không cần API key
- Dựng bằng DockerChạy một dòng lệnh để cài cả hệ thống và nạp dữ liệu
- Hoặc chạy chế độ phát triểnClone repo, cài gói, chạy npm run dev
- Mở trình duyệtVào localhost:3000 để xem bảng điều khiển
A.Chọn cách dùng
Người mới nên đi từ dễ đến khó. Thử npx trước, rất nhẹ. Thích giao diện web đầy đủ trên máy mình thì dùng Docker. Chỉ chọn chế độ phát triển nếu bạn muốn sửa code.
B.Thử nhanh bằng npx
Mở terminal (PowerShell hoặc Terminal đều được) ở thư mục bất kỳ, rồi gõ:
npx worldmonitorLệnh này tải gói worldmonitor về chạy tạm và mở bảng điều khiển ngay trong terminal. Bạn sẽ thấy 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.
Muốn xem danh sách công cụ MCP mà không cần key:
npx worldmonitor toolsC.Dựng bằng Docker (một dòng lệnh)
Cách này dựng cả hệ thống trên máy bạn: bảng điều khiển, Redis, AIS relay và dữ liệu công khai. Bạn cần mở terminal và đã có Docker chạy sẵn:
curl -fsSL https://www.worldmonitor.app/install.sh | bashTheo README, script sẽ clone vào 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 hệ thống và nạp dữ liệu. Sau đó bạn mở localhost:3000. Có các tuỳ chọn --dir, --port, --no-seed, --no-build, truyền sau bash -s --. Xem thêm bằng scripts/install.sh --help.
Chỗ người mới hay vấp: README chỉ ghi lệnh dạng bash. Tư liệu không nói rõ lệnh này chạy được trên PowerShell thuần của Windows hay không. Nếu dùng Windows, bạn nên đọc file SELF_HOSTING.md trong repo trước, hoặc dùng bản desktop cho đỡ rắc rối.
Lệnh "curl ... | bash" tải một script từ internet rồi chạy ngay. Hãy mở địa chỉ script bằng trình duyệt đọc qua trước. Chỉ chạy khi bạn tin nguồn. Cũng nên chạy trên máy hoặc máy chủ riêng, không phải máy chứa dữ liệu quan trọng.
D.Hoặc chạy chế độ phát triển
Dành cho bạn muốn xem code hoặc sửa. Trước hết kiểm tra Node.js:
node -vPhải ra phiên bản 24. Nếu thấp hơn, README gợi ý cài bằng nvm (gõ nvm install bên trong thư mục repo, nó đọc file .nvmrc) hoặc tải từ nodejs.org. Sau đó:
git clone https://github.com/koala73/worldmonitor.git
cd worldmonitor
npm install
npm run devTừng lệnh làm gì: git clone tải mã nguồn về, cd worldmonitor vào thư mục vừa tải, npm install cài các gói phụ thuộc, npm run dev khởi động máy chủ Vite có tự tải lại khi sửa code. Lỗi npm install ở bước hai thường do Node quá cũ, xem phần lỗi bên dưới.
Muốn đổi cổng, README nói đặt DEV_PORT trong file .env.local. Muốn chạy riêng từng biến thể:
npm run dev:tech
npm run dev:finance
npm run dev:commodity
npm run dev:happy
npm run dev:energyE.Mở trình duyệt
Cả Docker lẫn chế độ phát triển đều phục vụ ở địa chỉ http://localhost:3000. Ứng dụng chạy được khi chưa có biến môi trường nào. Nguồn dữ liệu nào cần khoá thì xem danh sách trong .env.example.
IV.Kiểm tra đã chạy được chưa
- Với
npx worldmonitor: terminal hiện bảng điều khiển có bản đồ, tin tức và các khung thị trường. Nếu hiện ra, bạn đã thành công. - Với
npx worldmonitor tools: lệnh in ra danh sách công cụ MCP mà không cần key. - Với Docker hoặc
npm run dev: mởhttp://localhost:3000thấy giao diện bảng điều khiển với bản đồ và các khung tin. README nói bản dựng không cần biến môi trường vẫn chạy. - Với chế độ phát triển: terminal sẽ in địa chỉ máy chủ sau khi
npm run devchạy xong. Nếu cổng 3000 không mở, xem lại thông báo lỗi ngay trên terminal đó.
V.Dùng vào việc thật
A.Chủ doanh nghiệp xuất nhập khẩu: nhìn nhanh điểm nóng buổi sáng
Bạn bán hàng đi nhiều nước và muốn biết sáng nay nơi nào đang căng thẳng, ảnh hưởng ra sao đến giá hàng hoá. Mở bản commodity hoặc bản world trên web, hoặc chạy trên máy mình:
npm run dev:commodityBạn xem khung hàng hoá và thị trường, bật lớp bản đồ liên quan, rồi đọc bản tóm tắt tin do AI tổng hợp. Kết quả là vài phút nắm tình hình thay vì phải mở nhiều trang riêng lẻ.
Chỉ cần một màn hình để biết thế giới đang nóng ở đâu.
Ông T
B.Nhân viên văn phòng hoặc nhà đầu tư: chạy ngay trong terminal
Bạn không muốn cài đặt phức tạp, chỉ muốn một cửa sổ luôn mở bên cạnh công việc. Chạy:
npx worldmonitorBạn có bản đồ, tin, thị trường và truyền hình trực tiếp trong một cửa sổ terminal, không cần tài khoản hay key. Phù hợp khi bạn thường làm việc trong terminal hoặc trên máy chủ từ xa.
C.Người làm phân tích rủi ro: tra điểm quốc gia bằng CLI
Bạn cần lấy chỉ số rủi ro của một nước để đưa vào báo cáo. README ghi ví dụ với mã nước IR và một khoá API:
npm install -g worldmonitor
worldmonitor risk IR --api-key wm_xxxThay wm_xxx bằng khoá của bạn. Kết quả là dữ liệu rủi ro trả về ngay trong terminal. Bạn có thể đưa vào bảng tính hoặc báo cáo. README chưa mô tả chi tiết định dạng kết quả, nên hãy chạy thử và xem trang tài liệu CLI.
D.Lập trình viên: nối vào AI agent qua MCP
Bạn đang dùng một AI agent hỗ trợ MCP và muốn nó tự tra dữ liệu thế giới. Máy chủ MCP của dự án nằm tại https://worldmonitor.app/mcp (Streamable HTTP). Danh sách công cụ (tools/list) công khai. Gọi công cụ (tools/call) cần header X-WorldMonitor-Key hoặc OAuth. Trước hết xem có những công cụ gì:
npx worldmonitor toolsSau khi nối, bạn có thể hỏi agent bằng câu thường như: "Tóm tắt các điểm nóng địa chính trị tuần này và nước nào có điểm bất ổn cao nhất". Cách khai báo MCP phụ thuộc vào agent bạn dùng, nên xem trang MCP Overview của dự án. Repo cũng có thư mục claude-plugin/ và file gemini-extension.json cho ai dùng Claude hoặc Gemini CLI. README chưa hướng dẫn chi tiết các thư mục này.
VI.Lỗi hay gặp và cách xử lý
npm installdừng vớiInvalid comparator: file:vendor/braces. Đây là lỗi README nhắc tên. Nguyên nhân là Node.js quá cũ (như Node 18 và npm 9.2.0 trên Debian 12 hoặc Raspberry Pi OS). Cách xử lý: cài Node.js 24 bằng nvm hoặc từ nodejs.org, rồi chạy lạinpm install.- Lệnh
curl ... | bashkhông chạy trên Windows. README ghi lệnh kiểu bash. Hãy thử mở Git Bash hoặc môi trường Linux (như WSL), hoặc đọcSELF_HOSTING.mdđể biết cách dựng thủ công. Nếu chỉ cần dùng thử, hãy chọn bản web hoặc bản desktop. - Cổng 3000 đã có chương trình khác dùng. Với chế độ phát triển, đặt
DEV_PORTtrong.env.local. Với script Docker, dùng tuỳ chọn--port. - Một số khung dữ liệu trống hoặc báo thiếu khoá. Ứng dụng chạy được khi không có biến môi trường, nhưng nguồn riêng lẻ có thể cần key. Mở
.env.example, xem biến tương ứng với nguồn (ví dụFINNHUB_API_KEY,FRED_API_KEY), điền vào file.env.localrồi khởi động lại. - MCP hoặc CLI trả lỗi xác thực.
tools/callcầnX-WorldMonitor-Keyhoặc OAuth, còn lệnh CLI cần--api-key. Kiểm tra khoá đã dán đúng, không thừa khoảng trắng.
Không dán API key vào chỗ công khai (kho mã, ảnh chụp màn hình, tin nhắn). Lưu khoá trong file môi trường cục bộ như `.env.local` và đừng đưa file đó lên GitHub.
VII.Có nên dùng không
Điểm mạnh. Bạn có rất nhiều cách vào cửa, từ bản web, bản desktop, một lệnh npx đến tự dựng. Bản terminal không cần key. Ứng dụng chạy được khi không có biến môi trường, và có thể chạy AI cục bộ với Ollama. Dự án có nhiều biến thể theo ngành (tài chính, hàng hoá, năng lượng…) và có sẵn máy chủ MCP, REST API, CLI, SDK cho người làm tự động hoá. Repo còn được cập nhật đều.
Giới hạn. Đây là hệ thống lớn: Docker, Redis, relay, nhiều nguồn dữ liệu. Tự dựng đầy đủ không còn là việc của người mới hoàn toàn. Chạy chế độ phát triển cần Node.js 24 đúng phiên bản. Nhiều nguồn dữ liệu cần khoá riêng, và README chưa nói giá của API key World Monitor. Chất lượng bản tóm tắt AI và độ chính xác của chỉ số như CII phụ thuộc vào nguồn dữ liệu, nên hãy xem đây là công cụ tham khảo, không phải lời khuyên đầu tư hay cảnh báo chính thức.
Giấy phép. Mã nguồn theo AGPL-3.0-only. README cho phép dùng cá nhân, nghiên cứu, tự chạy và dùng thương mại nếu bạn tuân thủ nghĩa vụ AGPL, trong đó có chia sẻ mã nguồn khi cần. Muốn dùng mã đóng hoặc dùng thương hiệu chính thức thì phải xin phép riêng. Nếu định làm dịch vụ thương mại, hãy đọc kỹ file LICENSE.
Khi nào chọn cách khác. Bạn chỉ cần một vài chỉ số cụ thể hoặc tin về một lĩnh vực hẹp? Một ứng dụng chuyên biệt có thể đơn giản hơn. Nếu bạn cần cam kết hỗ trợ và dữ liệu có hợp đồng, hãy xem lựa chọn thương mại. Còn nếu muốn một bảng điều khiển toàn cảnh, miễn phí để thử và mở mã nguồn, worldmonitor là lựa chọn rất đáng cân nhắc.
Câu hỏi thường gặp
worldmonitor có miễn phí không?
Mã nguồn mở theo giấy phép AGPL-3.0-only, và README nói bảng điều khiển terminal chạy không cần API key. Việc tự dựng cũng cho phép không dùng key, key chỉ là tuỳ chọn. Riêng API key của World Monitor để dùng MCP và CLI có xác thực thì README chỉ trang đăng ký, chưa có thông tin về giá.
Cần GPU hay máy cấu hình mạnh không?
Tư liệu không nêu yêu cầu phần cứng như GPU hay RAM tối thiểu. README chỉ nói có thể chạy AI cục bộ bằng Ollama, và phần AI/ML dùng Ollama hoặc OpenRouter. Muốn biết cấu hình cụ thể, hãy xem tài liệu của dự án.
Chạy được trên Windows không?
Có bản desktop (Tauri) cho Windows, macOS và Linux. Lệnh `npx worldmonitor` và chế độ phát triển cũng dùng Node.js. Riêng lệnh cài một dòng bằng `curl ... | bash` được ghi theo kiểu bash, README không nói rõ nó chạy ra sao trên Windows, nên bạn xem thêm SELF_HOSTING.md.
Cần phiên bản Node.js nào để chạy từ mã nguồn?
Cần Node.js 24, phiên bản được ghi trong file .nvmrc. README cảnh báo Node.js 18 trên Debian 12 và Raspberry Pi OS sẽ làm `npm install` lỗi với thông báo `Invalid comparator: file:vendor/braces`. Cách đơn giản là cài bằng nvm hoặc tải từ nodejs.org.
Có thể dùng nó với AI agent như Claude hoặc Gemini không?
Có máy chủ MCP tại https://worldmonitor.app/mcp. Danh sách công cụ công khai, còn gọi công cụ cần header X-WorldMonitor-Key hoặc OAuth. Repo cũng có thư mục claude-plugin/ và file gemini-extension.json, nhưng README chưa hướng dẫn chi tiết, nên bạn xem trang MCP Overview của dự án.
Dữ liệu của tôi có an toàn không khi tự dựng?
Khi tự dựng, hệ thống chạy trên máy hoặc máy chủ của bạn, và script cài đặt tạo các khoá bí mật cần thiết. Tư liệu không có cam kết cụ thể về quyền riêng tư. Hãy giữ API key trong file môi trường cục bộ và xem SECURITY.md cùng SELF_HOSTING.md trong repo.
Dự án có SDK cho ngôn ngữ lập trình nào?
README nêu SDK chính thức, không phụ thuộc thư viện khác, cho Python (worldmonitor-sdk), Ruby (worldmonitor) và Go (sdk/go). Chúng được thiết kế phản chiếu CLI. Hướng dẫn chi tiết nằm ở trang SDKs trong tài liệu của dự án.


