How to install on macOS

koala73/worldmonitor

Q: Does worldmonitor use paid AI services?

Can use Google Gemini or OpenRouter. Its settings have keys for these paid APIs. Its README says whether one is required.

Q: Is worldmonitor still maintained?

Yes, active. Last change today. Latest release v2.11.8, 4 days ago.

Q: Can I trust worldmonitor?

Some track record. 90k stars, 10 months old. Get it from the official repo and read what it installs.

Real-time global intelligence dashboard. AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface

Node.jsTauriVite#agent#ai#dashboard#geopolitics

Difficulty: Involved
Time: 30 min or more
Stars: ★ 90,330
Activity: Updated this month

Before you start

Is it free?: YesOpen source (AGPL-3.0).
Paid AI services?: Can use Google Gemini or OpenRouterIts settings have keys for these paid APIs. Its README says whether one is required.
Still maintained?: Yes, activeLast change today. Latest release v2.11.8, 4 days ago.
Can I trust it?: Some track record90k stars, 10 months old. Get it from the official repo and read what it installs.

Saved setup from 10 h ago

Will it work on macOS?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Your system

macOS Windows Linux

Start here

Website ↗worldmonitor.appThe project's own site.

Also: Docs ↗

Heads-upBuilding it yourself? It also needs Redis, PostgreSQL and 302 settings in .env (80 secret).

Download for macOS

World Monitor v2.11.8 · 11/4/2026 ↗

World.Monitor_2.11.8_aarch64.dmg

dmg · Apple Silicon · 69.2 MB · 286 downloads · best match

Download

Drag the app into Applications.

curl -LO "https://github.com/koala73/worldmonitor/releases/download/v2.11.8/World.Monitor_2.11.8_aarch64.dmg"
open "World.Monitor_2.11.8_aarch64.dmg"

Other macOS downloads (1)

World.Monitor_2.11.8_x64.dmg

dmg · Intel · 70.6 MB · 137 downloads

Download

Drag the app into Applications.

curl -LO "https://github.com/koala73/worldmonitor/releases/download/v2.11.8/World.Monitor_2.11.8_x64.dmg"
open "World.Monitor_2.11.8_x64.dmg"

Install with a package manager

install script

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

Pipes a remote script into your shell. Read it before running.

npm

npm install -g worldmonitor     # or install the `worldmonitor` (alias `wm`) command

Homebrew

brew install worldmonitor       # or install it with Homebrew

npm

npm install -g worldmonitor

Homebrew

brew install worldmonitor

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

1×Node.js 24runtime
1×Rust stableruntime
1×npm package manager
1×Redis service
1×PostgreSQL service

302× settings in .env

WORLDMONITOR_API_KEYsecret
ANTHROPIC_API_KEYsecret
ELEVENLABS_API_KEYsecretoptional
ELEVENLABS_VOICE_IDoptional
LIVEAVATAR_API_KEYsecretoptional
LIVEAVATAR_AVATAR_IDoptional
LIVEAVATAR_VOICE_IDoptional
DATABASE_URL
DATABASE_SSL_CA
REDIS_URL
FIRECRAWL_API_KEYsecret
EXA_API_KEYSsecret
EXA_API_KEYsecret
P0_API_KEYsecret
P0_BASE_URL
ARTIFACTS_BUCKET_URLoptional
ARTIFACTS_BUCKET_KEYsecretoptional
ARTIFACTS_BUCKET_SECRETsecretoptional
PORT
HOST
LOG_LEVEL
WORLDMONITOR_SNAPSHOT_API_KEYsecret
CORS_ORIGIN
GEMINI_API_KEYsecret
APP_URL
VITE_CLERK_PUBLISHABLE_KEYsecret
OPENROUTER_API_KEYsecret
FORECAST_LLM_PROVIDER_ORDERoptional
FORECAST_LLM_MODEL_OPENROUTERoptional
FORECAST_LLM_COMBINED_PROVIDER_ORDERoptional
FORECAST_LLM_COMBINED_MODEL_OPENROUTERoptional
FORECAST_LLM_CRITICAL_PROVIDER_ORDERoptional
FORECAST_LLM_CRITICAL_MODEL_OPENROUTERoptional
FORECAST_LLM_MARKET_IMPLICATIONS_PROVIDER_ORDERoptional
FORECAST_LLM_MARKET_IMPLICATIONS_MODEL_OPENROUTERoptional
FORECAST_EVIDENCE_CUTOVER_ENABLED
FORECAST_EVIDENCE_COVERAGE_MAX_LAG_MS
UPSTASH_REDIS_REST_URL
UPSTASH_REDIS_REST_TOKENsecret
REDIS_PASSWORDsecret
REDIS_TOKENsecret
GOOGLE_FACT_CHECK_API_KEYsecret
FINNHUB_API_KEYsecret
EIA_API_KEYsecret
USDA_FAS_PSD_API_KEYsecret
FRED_API_KEYsecret
IMF_API_KEYsecretoptional
ESTAT_APPID
SAM_GOV_API_KEYsecretoptional
MANITOBA_511_KEYsecret
OPENAQ_API_KEYsecret
WAQI_API_KEYsecretoptional
AVIATIONSTACK_API
AVIATIONSTACK_MIN_REFRESH_MINoptional
AVIATIONSTACK_MONTHLY_BUDGEToptional
AVIATIONSTACK_REQUEST_BUDGEToptional
ICAO_API_KEYsecretoptional
NOTAM_KEYsecret
NOTAM_SECRETsecret
NMS_API_HOST

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/koala73/worldmonitor/badge.svg)](https://gitmanual.com/koala73/worldmonitor)

Good to know

Tauri desktop app: it also needs Tauri's system prerequisites (Xcode Command Line Tools on macOS, WebView2 and the C++ build tools on Windows, webkit2gtk on Linux). See https://tauri.app/start/prerequisites/
Dockerfile available (base image: node:24-alpine@sha256:8a32c8cf649a49915a66e81e7a609223c708d0adabf288ee3f4077d765542f85).
Makefile has a make install target — it may automate most of these steps.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: blog-site/package.json, cli/package.json, consumer-prices-core/package.json, demos/verification-desk/package.json and 11 more

Details

License: AGPL-3.0
Open issues: 319
Branch: main

package.json scripts (220)

lintbiome lint ./src ./server ./api ./tests ./e2e ./scripts ./middleware.ts && npm run lint:safe-html
lint:fixbiome check ./src ./server ./api ./tests ./e2e ./scripts ./middleware.ts --fix
lint:boundariesnode scripts/lint-boundaries.mjs
lint:api-contractnode scripts/enforce-sebuf-api-contract.mjs
lint:safe-htmlnode scripts/enforce-safe-html.mjs
lint:panel-content-writesnode scripts/enforce-panel-content-writes.mjs
lint:safe-local-storagenode scripts/enforce-safe-local-storage.mjs
lint:overlay-reload-policynode scripts/enforce-overlay-reload-policy.mjs
lint:rate-limit-policiestsx scripts/enforce-rate-limit-policies.mjs
lint:premium-fetchtsx scripts/enforce-premium-fetch.mjs
lint:outbound-deadlinesnode scripts/audit-outbound-calls.mjs --check
lint:mintlify-slugsnode scripts/enforce-mintlify-reserved-slugs.mjs
lint:public-docsnode scripts/check-public-doc-plan-references.mjs
lint:unicodenode scripts/check-unicode-safety.mjs
lint:unicode:stagednode scripts/check-unicode-safety.mjs --staged
security:local-env-dumpsnode scripts/check-local-secret-dumps.mjs
security:vite-env-secretsnode scripts/check-vite-env-secrets.mjs
agent:preflightnode scripts/agent-preflight.mjs
agent:pr-snapshotnode scripts/agent-pr-snapshot.mjs
agent:attach-pr-evidencenode scripts/publish-pr-media-evidence.mjs
railway:cross-strait-history:forcenode scripts/run-cross-strait-history-one-off.mjs
worktree:bootstrapnode scripts/bootstrap-worktree.mjs
worktree:bootstrap:test-onlynode scripts/bootstrap-worktree.mjs --ignore-scripts
worktree:envnode scripts/bootstrap-worktree.mjs --skip-install
lint:mdmarkdownlint-cli2 '**/*.md' '!**/node_modules/**' '!.agent/**' '!.agents/**' '!.claude/**' '!.factory/**' '!.windsurf/**' '!skills/**' '!docs/internal/**' '!docs/Docs_To_Review/**' '!docs/archive/**' '!todos/**' '!docs/plans/**' '!docs/brainstorms/**' '!docs/ideation/**'

Files we read (17)

.env.example

.github/workflows/build-desktop.yml

.github/workflows/china-decision-parity-live.yml

.github/workflows/ci-health-scan.yml

.github/workflows/deploy-railway-reconcile-control.yml

.github/workflows/lint-code.yml

.github/workflows/proto-check.yml

.nvmrc

Dockerfile

Makefile

README.md

consumer-prices-core/.env.example

demos/verification-desk/.env.example

docker-compose.yml

docs/getting-started.mdx

package.json

pro-test/.env.example

9,761 files in the repo

Reading the repo

Opening the box…

Before you start

Is it free?

YesOpen source (AGPL-3.0).

Paid AI services?

Can use Google Gemini or OpenRouterIts settings have keys for these paid APIs. Its README says whether one is required.

Still maintained?

Yes, activeLast change today. Latest release v2.11.8, 4 days ago.

Can I trust it?

Some track record90k stars, 10 months old. Get it from the official repo and read what it installs.

Start here

Heads-upBuilding it yourself? It also needs Redis, PostgreSQL and 302 settings in .env (80 secret).

Parts list

1×Node.js 24runtime

1×Rust stableruntime

1×npm package manager

1×Redis service

1×PostgreSQL service

302× settings in .env

WORLDMONITOR_API_KEYsecret
ANTHROPIC_API_KEYsecret
ELEVENLABS_API_KEYsecretoptional
ELEVENLABS_VOICE_IDoptional
LIVEAVATAR_API_KEYsecretoptional
LIVEAVATAR_AVATAR_IDoptional
LIVEAVATAR_VOICE_IDoptional
DATABASE_URL
DATABASE_SSL_CA
REDIS_URL
FIRECRAWL_API_KEYsecret
EXA_API_KEYSsecret
EXA_API_KEYsecret
P0_API_KEYsecret
P0_BASE_URL
ARTIFACTS_BUCKET_URLoptional
ARTIFACTS_BUCKET_KEYsecretoptional
ARTIFACTS_BUCKET_SECRETsecretoptional
PORT
HOST
LOG_LEVEL
WORLDMONITOR_SNAPSHOT_API_KEYsecret
CORS_ORIGIN
GEMINI_API_KEYsecret
APP_URL
VITE_CLERK_PUBLISHABLE_KEYsecret
OPENROUTER_API_KEYsecret
FORECAST_LLM_PROVIDER_ORDERoptional
FORECAST_LLM_MODEL_OPENROUTERoptional
FORECAST_LLM_COMBINED_PROVIDER_ORDERoptional
FORECAST_LLM_COMBINED_MODEL_OPENROUTERoptional
FORECAST_LLM_CRITICAL_PROVIDER_ORDERoptional
FORECAST_LLM_CRITICAL_MODEL_OPENROUTERoptional
FORECAST_LLM_MARKET_IMPLICATIONS_PROVIDER_ORDERoptional
FORECAST_LLM_MARKET_IMPLICATIONS_MODEL_OPENROUTERoptional
FORECAST_EVIDENCE_CUTOVER_ENABLED
FORECAST_EVIDENCE_COVERAGE_MAX_LAG_MS
UPSTASH_REDIS_REST_URL
UPSTASH_REDIS_REST_TOKENsecret
REDIS_PASSWORDsecret
REDIS_TOKENsecret
GOOGLE_FACT_CHECK_API_KEYsecret
FINNHUB_API_KEYsecret
EIA_API_KEYsecret
USDA_FAS_PSD_API_KEYsecret
FRED_API_KEYsecret
IMF_API_KEYsecretoptional
ESTAT_APPID
SAM_GOV_API_KEYsecretoptional
MANITOBA_511_KEYsecret
OPENAQ_API_KEYsecret
WAQI_API_KEYsecretoptional
AVIATIONSTACK_API
AVIATIONSTACK_MIN_REFRESH_MINoptional
AVIATIONSTACK_MONTHLY_BUDGEToptional
AVIATIONSTACK_REQUEST_BUDGEToptional
ICAO_API_KEYsecretoptional
NOTAM_KEYsecret
NOTAM_SECRETsecret
NMS_API_HOST