worldmonitor: bảng điều khiển tin tức, địa chính trị theo 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
World Monitor (repo koala73/worldmonitor) là một bảng điều khiển mã nguồn mở gom tin tức, bản đồ, thị trường, quân sự, an ninh mạng và khí hậu vào một giao diện, có AI tóm tắt. Bạn có thể dùng bản web, ứng dụng desktop, chạy trong terminal bằng một lệnh npx, hoặc tự dựng bằng Docker. Cách nhanh nhất là chạy npx worldmonitor, không cần API key.
World Monitor là một bảng điều khiển "tình báo toàn cầu" chạy theo thời gian thực, mã nguồn mở, viết bằng TypeScript. Nó gom tin tức, bản đồ, thị trường tài chính, chuyến bay quân sự, an ninh mạng, khí hậu và nhiều nguồn khác vào một giao diện duy nhất, rồi dùng AI để tóm tắt thành bản tin ngắn.
Vấn đề nó giải quyết rất đời thường: để theo dõi chuyện đang xảy ra trên thế giới, bạn phải mở hàng chục tab, trang tin, bản đồ và bảng giá. World Monitor đặt tất cả lên một màn hình. Nó hợp với người làm kinh doanh cần theo dõi rủi ro chuỗi cung ứng, giá hàng hoá, tin địa chính trị. Nó cũng hợp với dân văn phòng thích đọc tin tổng hợp, và lập trình viên muốn có nguồn dữ liệu cho agent hay script của mình.
Điểm đáng giá nhất là bạn có nhiều cách dùng, từ dễ đến khó: mở web, tải app desktop, chạy một lệnh trong terminal, hoặc tự dựng cả hệ thống ở máy mình. Repo hiện có khoảng 90.557 sao và 14.047 fork, và vẫn được cập nhật trong vài tháng gần đây.
koala73/worldmonitor
World Monitor là bảng điều khiển tình báo toàn cầu thời gian thực: gom tin tức, theo dõi địa chính trị, thị trường và hạ tầng trên một màn hình, có AI tóm tắt.
I.World Monitor làm được gì
Dưới đây là các tính năng chính, giải thích theo lợi ích thực tế.
- Tin tức chọn lọc, AI tóm tắt. Repo gom nhiều nguồn tin toàn cầu và theo khu vực, rồi tổng hợp thành bản tóm tắt. Bạn không phải đọc từng bài để nắm ý chính.
- 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 hay tắt từng lớp để xem thứ mình quan tâm.
- Đối chiếu nhiều luồng tín hiệu. Hệ thống tìm những lúc tín hiệu quân sự, kinh tế, thiên tai và leo thang căng thẳng cùng xuất hiện. Đây là chỗ giúp bạn thấy bức tranh chung thay vì từng mẩu tin rời.
- Chỉ số bất ổn quốc gia (CII). Theo README, đâ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.
- 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. Điều này hữu ích nếu bạn không muốn gửi dữ liệu ra ngoài.
- Nhiều biến thể từ một mã nguồn. Có các bản world, tech, finance, commodity, happy và energy. Ví dụ người theo dõi hàng hoá dùng bản commodity, người làm năng lượng dùng bản energy.
- Ứng dụng desktop (Tauri 2). Có cho macOS, Windows và Linux. Một file cài đặt dùng cho mọi biến thể, bạn đổi biến thể ngay trong app.
- Giao diện đa ngôn ngữ, có luồng tin bằng tiếng bản địa và hỗ trợ chữ viết từ phải sang trái.
Với lập trình viên, repo còn có máy chủ MCP, REST API, công cụ CLI và các SDK (Python, Ruby, Go). Phần này mình nói kỹ hơn ở các tình huống bên dưới.
II.Cần chuẩn bị gì
Tuỳ cách dùng, bạn cần những thứ khác nhau. Mình chỉ liệt kê những gì README nói.
- Chỉ xem thử: mở bản web ở worldmonitor.app, không cần cài gì.
- Chạy bảng điều khiển trong terminal: cần Node.js để dùng được lệnh
npx. README không ghi rõ phiên bản tối thiểu cho riêng cách này. Terminal dashboard chạy dữ liệu trực tiếp và README ghi rõ không cần API key. - Tự dựng cả hệ thống bằng Docker: cần có Docker. Lệnh cài một dòng sẽ tự sinh các khoá bí mật cần thiết. API key bên thứ ba là tuỳ chọn.
- Chạy chế độ phát triển (dev): cần Node.js 24, đúng phiên bản được ghim trong file
.nvmrc. README cảnh báo các gói cài sẵn trong hệ điều hành thường cũ hơn. Debian 12 và Raspberry Pi OS đi kèm Node.js 18 và npm 9.2.0, ở đónpm installsẽ dừng với lỗiInvalid comparator: file:vendor/braces. Bạn nên cài Node.js 24 bằng nvm hoặc tải từ trang nodejs.org. - Tài khoản và 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 chuyên biệt có thể cần thông tin đăng nhập; danh sách đầy đủ nằm trong file
.env.example. Muốn gọi máy chủ MCP bằng công cụ có xác thực thì cần API key lấy ở trang worldmonitor.app/pro.
README không nêu yêu cầu phần cứng cụ thể (RAM, GPU). Nếu bạn định chạy AI cục bộ bằng Ollama, hãy xem tài liệu của Ollama để biết máy mình có đủ sức hay không.
Các khoá API (nếu bạn điền) nằm trong file cấu hình trên máy bạn. Đừng chụp màn hình, đừng đẩy file .env lên GitHub hay gửi cho người khác. Một số dịch vụ AI tính tiền theo lượt dùng, nên hãy kiểm tra gói cước trước khi bật.
III.Cài đặt từng bước
Có nhiều đường cài. Mình xếp từ dễ nhất đến kỹ nhất, bạn chọn một đường phù hợp.
- Thử nhanh bằng npxChạy bảng điều khiển trong terminal, không cần key
- Cài công cụ CLICài lệnh worldmonitor để gọi dữ liệu từ dòng lệnh
- Tự dựng bằng DockerMột dòng lệnh cài cả hệ thống, mở ở localhost:3000
- Chạy chế độ phát triểnClone repo, npm install, npm run dev
- Chọn biến thểChạy bản tech, finance, commodity, happy hoặc energy
A.Cách nhanh nhất: chạy bảng điều khiển trong terminal
Mở terminal (PowerShell trên Windows, Terminal trên macOS hoặc Linux) rồi chạy lệnh dưới đây. Máy phải có Node.js. README ghi lệnh này chạy cùng dữ liệu trực tiếp như bản web: 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, có hỗ trợ chuột và nhiều giao diện màu.
npx worldmonitorKhi chạy không kèm tham số trong terminal, lệnh sẽ mở bảng điều khiển. Nếu bạn muốn liệt kê mọi công cụ MCP mà không cần key, README gợi ý:
npx worldmonitor toolsB.Cài lệnh worldmonitor dùng lâu dài
Nếu bạn thấy tiện và muốn có sẵn lệnh trong máy, README ghi hai cách:
npm install -g worldmonitorbrew install worldmonitorCách đầu dùng npm (có ở mọi hệ điều hành đã cài Node.js). Cách sau dùng Homebrew, thường gặp trên macOS. Sau khi cài, README nói bạn có lệnh worldmonitor và bí danh ngắn wm. Ví dụ tra rủi ro của một quốc gia bằng API key:
worldmonitor risk IR --api-key wm_xxxChỗ wm_xxx là chỗ bạn thay bằng key thật của mình.
C.Tự dựng cả hệ thống bằng Docker
Đây là cách "đầy đủ" nhất: bảng điều khiển, Redis, bộ chuyển tiếp AIS và dữ liệu công khai đã nạp sẵn. README cho một lệnh duy nhất:
curl -fsSL https://www.worldmonitor.app/install.sh | bashLệnh này tải về mã nguồn vào thư mục ./worldmonitor (hoặc dùng lại bản bạn đã clone), tự sinh các khoá bí mật cần thiết, khởi động hệ thống và nạp dữ liệu. Xong thì mở trình duyệt vào http://localhost:3000.
README còn nhắc các tuỳ chọn --dir, --port, --no-seed, --no-build, đặt sau bash -s --. Xem thêm bằng scripts/install.sh --help. Chi tiết về chạy thật (production) và cách gỡ cài đặt nằm trong file SELF_HOSTING.md của repo.
Chỗ người mới hay vấp: lệnh này cần môi trường có bash và Docker đã chạy sẵn. README không nói rõ về Windows cho cách này, nên nếu bạn dùng Windows hãy đọc SELF_HOSTING.md trước khi làm.
D.Chạy chế độ phát triển
Cách này hợp với lập trình viên muốn xem và sửa mã. Đảm bảo bạn đã có Node.js 24 (xem phần chuẩn bị). Mở terminal ở thư mục bạn muốn đặt mã nguồn, rồi chạy:
git clone https://github.com/koala73/worldmonitor.git
cd worldmonitor
npm install
npm run devGiải thích: git clone tải mã về, cd worldmonitor đi vào thư mục vừa tải, npm install cài các thư viện cần thiết, npm run dev khởi động máy chủ phát triển có tải lại nóng. Sau đó mở http://localhost:3000. Nếu cổng 3000 bị chiếm, README nói bạn đổi cổng bằng biến DEV_PORT trong file .env.local. Ứng dụng chạy được mà không cần biến môi trường nào.
E.Chọn biến thể theo nhu cầu
Muốn chạy riêng từng biến thể, dùng một trong các lệnh sau (chạy trong 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.appIV.Kiểm tra đã chạy được chưa
Tuỳ cách cài, dấu hiệu thành công khác nhau.
- Với
npx worldmonitor: terminal chuyển thành giao diện bảng điều khiển, có bản đồ, tin tức và thị trường. Bạn dùng chuột để bấm được. - Với Docker hoặc
npm run dev: mởhttp://localhost:3000trong trình duyệt và thấy giao diện World Monitor tải ra, có bản đồ và các ô thông tin. Nếu bạn đã đổi cổng bằng--porthayDEV_PORT, hãy dùng đúng cổng đó. - Với CLI: chạy
npx worldmonitor toolssẽ in ra danh sách các công cụ MCP. README ghi lệnh này không cần key.
Nếu bạn muốn kiểm tra mã nguồn sau khi sửa, README có hai lệnh dành cho người đóng góp: npm run typecheck (kiểm tra kiểu) và npm run build:full (build bản chạy thật).
V.Dùng vào việc thật
A.Chủ doanh nghiệp xuất nhập khẩu theo dõi rủi ro hằng ngày
Bạn bán hàng đi nhiều nước và lo tuyến vận chuyển hay biến động giá. Mỗi sáng, thay vì lướt nhiều trang, bạn chạy bản hàng hoá:
npm run dev:commodityBạn mở bản đồ, bật các lớp liên quan, xem tin được AI tóm tắt và radar thị trường hàng hoá. Kết quả là một màn hình duy nhất cho bạn nắm biến động đáng chú ý trước khi họp đầu ngày. Nếu không muốn tự dựng, bạn mở thẳng bản commodity trên web.
B.Nhân viên văn phòng đọc tin tổng hợp ngay trong terminal
Bạn làm việc cả ngày với cửa sổ dòng lệnh và không muốn mở thêm trình duyệt. Chỉ cần:
npx worldmonitorBạn có bản đồ thế giới, tin tức, thị trường và truyền hình trực tiếp ngay trong terminal, đổi giao diện màu cho dễ nhìn. Đây là cách ít tốn công cài đặt nhất và không cần key.
Muốn nắm thế giới đang chuyển động ra sao, bạn không cần mười tab — chỉ cần một màn hình biết gom đúng thứ.
Ông T
C.Lập trình viên gắn dữ liệu vào agent hoặc script
Bạn đang viết một agent hay một script báo cáo và cần dữ liệu về rủi ro quốc gia. README cho bạn nhiều đường: máy chủ MCP tại https://worldmonitor.app/mcp (danh sách công cụ tools/list công khai, còn tools/call cần header X-WorldMonitor-Key hoặc OAuth), REST API tại https://api.worldmonitor.app, CLI và các SDK (Python worldmonitor-sdk, Ruby worldmonitor, Go). Với CLI, bạn thử như sau:
worldmonitor risk IR --api-key wm_xxxKết quả là dữ liệu rủi ro cho quốc gia có mã IR, bạn đưa tiếp vào bảng tính hoặc agent của mình. Key lấy ở trang worldmonitor.app/pro, theo README.
D.Người chú trọng riêng tư muốn tự dựng và dùng AI cục bộ
Bạn không muốn gửi dữ liệu ra dịch vụ AI bên ngoài. README nói World Monitor có thể chạy với Ollama mà không cần API key. Bạn dựng bằng Docker như ở phần cài đặt, rồi xem SELF_HOSTING.md và .env.example để biết cách cấu hình. Mình không có thông tin chi tiết hơn về tên biến cho Ollama trong tư liệu, nên bạn hãy đọc hai file đó trực tiếp.
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 README nêu rõ: máy bạn đang dùng Node.js hoặc npm quá cũ (ví dụ Node.js 18 với npm 9.2.0 trên Debian 12 và Raspberry Pi OS). Cách xử lý: cài Node.js 24 bằng nvm (chạy nvm install bên trong thư mục repo, nó đọc .nvmrc) hoặc tải từ nodejs.org, rồi chạy lại npm install.
B.Lệnh npx hay npm không được nhận ra
Điều này thường nghĩa là máy chưa cài Node.js, hoặc bạn chưa mở lại terminal sau khi cài. Hãy cài Node.js, đóng terminal rồi mở lại. Với Windows, mở lại PowerShell sau khi cài là cách an toàn nhất.
C.Không mở được localhost:3000
Có thể máy chủ chưa khởi động xong, hoặc cổng đang bị chương trình khác dùng. Hãy chờ vài chục giây và xem terminal có báo lỗi không. Nếu cổng bị chiếm, README cho biết bạn đổi cổng bằng DEV_PORT trong .env.local (chế độ dev) hoặc dùng tuỳ chọn --port của lệnh cài Docker.
D.Một số ô dữ liệu trống hoặc báo thiếu
README nói một số nguồn dữ liệu chuyên biệt có thể cần thông tin đăng nhập. File .env.example liệt kê các biến như FINNHUB_API_KEY, FRED_API_KEY, EIA_API_KEY. Nếu bạn cần đúng nguồn nào, hãy đăng ký key của nguồn đó và điền vào file cấu hình trên máy mình. Đừng đưa key vào chỗ công khai.
E.Lệnh cài một dòng với curl | bash chạy không như ý
Lệnh này tải và chạy một script ngay lập tức. Nếu bạn muốn an toàn hơn, hãy tải script về đọc trước, hoặc clone repo rồi xem scripts/install.sh --help và SELF_HOSTING.md. Cũng kiểm tra Docker đã được bật trước khi chạy.
VII.Có nên dùng không
Điểm mạnh. Nhiều cách dùng từ dễ đến khó, trong đó cách npx worldmonitor không cần key và không cần cài phức tạp. Một mã nguồn cho nhiều biến thể (thế giới, công nghệ, tài chính, hàng hoá, năng lượng). Có cả ứng dụng desktop, CLI, SDK và máy chủ MCP, nên dùng được cho cả người xem lẫn người lập trình. Repo được cập nhật thường xuyên và có cộng đồng lớn.
Giới hạn. Nhiều nguồn dữ liệu chuyên biệt cần key riêng. Một số tính năng chạy qua API chính thức cần key lấy từ trang của dự án. Tự dựng hệ thống đầy đủ đòi hỏi Docker và chút kiến thức kỹ thuật. README không nêu rõ yêu cầu phần cứng cho AI cục bộ, nên bạn cần tự thử.
Giấy phép. Mã nguồn theo AGPL-3.0-only. Dùng cá nhân, nghiên cứu, học tập và tự dựng đều được. Dùng thương mại hay làm SaaS vẫn được nếu bạn tuân thủ nghĩa vụ của AGPL, tức là chia sẻ mã nguồn khi cần. Nếu bạn muốn dùng mã đóng hoặc dùng thương hiệu chính thức thì cần xin phép riêng. Doanh nghiệp nên đọc kỹ file LICENSE trước khi đưa vào sản phẩm.
Khi nên chọn cách khác. Nếu bạn chỉ cần đọc tin thông thường, một ứng dụng đọc tin đơn giản là đủ. Nếu bạn cần dữ liệu có cam kết dịch vụ cho hệ thống quan trọng, hãy xem các điều khoản và gói chính thức của dự án trước khi phụ thuộc vào nó. Còn nếu bạn tò mò, cứ thử npx worldmonitor — mất vài phút và không tốn gì.
Câu hỏi thường gặp
World Monitor có miễn phí không?
Mã nguồn được phát hành theo giấy phép AGPL-3.0-only, và README nói việc dùng cá nhân, nghiên cứu hay tự dựng đều được. Bảng điều khiển trong terminal chạy bằng npx và không cần API key. Để gọi máy chủ MCP có xác thực thì cần key lấy ở trang worldmonitor.app/pro, còn giá cả thì tư liệu chưa nêu.
Cài World Monitor có cần GPU không?
README không nêu yêu cầu GPU hay phần cứng nào. Bạn chỉ cần Node.js (bản 24 với chế độ dev) hoặc Docker tuỳ cách cài. Nếu chạy AI cục bộ bằng Ollama, bạn nên xem yêu cầu của Ollama cho mô hình mình chọn.
Có chạy được trên Windows không?
Có. README cho biết ứng dụng desktop Tauri có bản tải cho Windows, macOS và Linux. Các lệnh npx và npm cũng chạy trong terminal có Node.js. Riêng lệnh cài một dòng với curl và bash, README không nói rõ về Windows, nên bạn xem thêm file SELF_HOSTING.md.
Cách đơn giản nhất để thử là gì?
Mở bản web ở worldmonitor.app, hoặc chạy lệnh npx worldmonitor trong terminal nếu đã có Node.js. Cách thứ hai hiển thị bảng điều khiển ngay trong terminal với bản đồ, tin tức, thị trường và truyền hình trực tiếp, và README ghi rõ không cần API key.
Dữ liệu của tôi có an toàn không?
Khi tự dựng, hệ thống chạy trên máy hoặc máy chủ của bạn. README cũng nói bạn có thể chạy AI bằng Ollama mà không cần API key bên ngoài. Tư liệu không có thêm cam kết nào về quyền riêng tư của bản web, nên nếu quan tâm hãy đọc file SECURITY.md và tài liệu của dự án.
Tôi có thể dùng World Monitor với agent hay script của mình không?
Có. README nói dự án có máy chủ MCP tại worldmonitor.app/mcp, REST API tại api.worldmonitor.app, công cụ CLI và SDK cho Python, Ruby và Go. Lệnh tools/list của MCP là công khai, còn tools/call cần header X-WorldMonitor-Key hoặc OAuth.
Dùng cho mục đích thương mại có được không?
README nói được, miễn là bạn tuân thủ AGPL-3.0-only, gồm cả nghĩa vụ chia sẻ mã nguồn khi cần. Nếu muốn dùng mã đóng hoặc dùng thương hiệu chính thức thì cần xin phép riêng. README cũng nhắc có thể thương lượng giấy phép thương mại khác cho nhóm cần điều khoản không phải AGPL.


