Bỏ qua tới nội dung
Ông T.vn

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

11 phút đọcCập nhật

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 →

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

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.

Ứng dụng

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.

★ 91kTypeScriptAGPL-3.0
Xem repo trên GitHub

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ùng npx nê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ến npm install dừng với lỗi Invalid 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.example liệ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-Key hoặ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

  1. 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
  2. Thử nhanh bằng npxMở bảng điều khiển trong terminal, không cần API key
  3. Dựng bằng DockerChạy một dòng lệnh để cài cả hệ thống và nạp dữ liệu
  4. Hoặc chạy chế độ phát triểnClone repo, cài gói, chạy npm run dev
  5. 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õ:

Terminal
npx worldmonitor

Lệ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:

Terminal
npx worldmonitor tools

C.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:

Terminal
curl -fsSL https://www.worldmonitor.app/install.sh | bash

Theo 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:

Terminal
node -v

Phả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 đó:

Terminal
git clone https://github.com/koala73/worldmonitor.git
cd worldmonitor
npm install
npm run dev

Từ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ể:

Terminal
npm run dev:tech
npm run dev:finance
npm run dev:commodity
npm run dev:happy
npm run dev:energy

E.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:3000 thấ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 dev chạ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:

Terminal
npm run dev:commodity

Bạ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:

Terminal
npx worldmonitor

Bạ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:

Terminal
npm install -g worldmonitor
worldmonitor risk IR --api-key wm_xxx

Thay 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ì:

Terminal
npx worldmonitor tools

Sau 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 install dừng với Invalid 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ại npm install.
  • Lệnh curl ... | bash khô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 đọc SELF_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_PORT trong .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.local rồi khởi động lại.
  • MCP hoặc CLI trả lỗi xác thực. tools/call cần X-WorldMonitor-Key hoặ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.

4.9/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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.

Chuyển nhanh tới mục

  1. I.worldmonitor làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Chọn cách dùng
    2. B.Thử nhanh bằng npx
    3. C.Dựng bằng Docker (một dòng lệnh)
    4. D.Hoặc chạy chế độ phát triển
    5. E.Mở trình duyệt
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ doanh nghiệp xuất nhập khẩu: nhìn nhanh điểm nóng buổi sáng
    2. B.Nhân viên văn phòng hoặc nhà đầu tư: chạy ngay trong terminal
    3. C.Người làm phân tích rủi ro: tra điểm quốc gia bằng CLI
    4. D.Lập trình viên: nối vào AI agent qua MCP
  6. VI.Lỗi hay gặp và cách xử lý
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.