このプロジェクトについて

## 概要 World Monitorは、AIによるニュース集約、地政学的モニタリング、およびインフラ追跡を一つの状況把握インターフェースに統合したリアルタイム・グローバルインテリジェンス・ダッシュボードです。単一のコードベースから構築されており、world、tech、finance、commodity、happy、energyという複数のサイトバリアントを提供しています。 ## 実装機能 - AIによって要約された、グローバルおよび地域カテゴリー別のキュレート済みニュースフィード。 - デュアルマップエンジン：globe.glで構築された3D地球儀と、deck.glで構築されたWebGL平面マップを備え、マップレイヤーカタログを共有。 - 特化型バリアント全体にわたる具体的なパネル実装を備えたパネルインベントリ。 - 軍事、経済、災害、およびエスカレーション信号のクロスストリーム相関分析。 - Country Instability Index (CII)：31のティア1国家を対象とした、ライブCII v8スコア、バンド、および概算24時間変動の表示。 - 証券取引所、コモディティ、仮想通貨、および市場複合指数をカバーする金融レーダー。 - OllamaによるローカルAI運用（APIキー不要）。また、Groq、OpenRouter、およびブラウザ側のTransformers.jsもサポート。 - macOS（Apple SiliconおよびIntel）、Windows、Linux AppImage向けのネイティブデスクトップアプリ（Tauri 2）。一つのバイナリで全バリアントをカバーし、アプリ内で切り替え可能。 - ネイティブ言語フィードとRTL（右から左に読む言語）をサポートする多言語UI。 ## 実行方法 クイックスタートの手順は、リポジトリをクローンし、`npm install` と `npm run dev` を実行して localhost:3000（`DEV_PORT` でポート変更可能）を開くことです。アプリは環境変数なしで動作しますが、機能固有のデータソースには `.env.example` に記載された認証情報が必要な場合があります。バリアント固有の開発スクリプト（`dev:tech`、`dev:finance`、`dev:commodity`、`dev:happy`、`dev:energy`）も用意されています。セルフホスティングのオプションとして、Vercel、Docker、および静的デプロイメントが挙げられています。 ## プログラムによるアクセス ブラウザUI以外に、以下の機能がドキュメント化されています： - `https://worldmonitor.app/mcp` で提供されるMCPサーバー（ストリーマブルHTTP）。公開されている `tools/list` と認証が必要な `tools/call` に加え、ドラフト版MCPスキル拡張を通じて公開されるAgent Skillsを備えています。 - OpenAPI仕様で記述された `https://api.worldmonitor.app` のREST API。 - `npx` 経由でアドホックに実行可能、または `worldmonitor` / `wm` としてグローバルにインストール可能な公式の `worldmonitor` npm CLI。 - Python (`worldmonitor-sdk`)、Ruby、Go向けの公式ゼロ依存SDK。 また、`llms.txt`、エージェントスキルマニフェスト、APIカタログなどのエージェント探索用ファイルも公開されています。 ## 技術スタック フロントエンドにはバニラTypeScriptとViteを使用。デスクトップ版にはTauri 2 (Rust) とNode.jsサイドカーを採用。AIにはOllama、Groq、OpenRouter、Transformers.jsを利用。APIコントラクトにはProtocol Buffersとsebuf HTTPアノテーションを使用。デプロイにはVercel Edge Functions、Railwayリレー、Tauri、PWAを利用し、キャッシュにはRedis (Upstash) による3層キャッシュ、CDN、およびサービスワーカーを導入しています。 ## データソースと帰属 データは、地政学、金融、エネルギー、気候、航空、サイバー、軍事、インフラ、ニュースインテリジェンスにわたる帰属明記済みのアップストリームプロバイダーから集約されています。航空データはWingbitsに帰属します。データソースカタログには、プロバイダー、フィードティア、ライセンス状況、および収集方法が記載されています。 ## ライセンスとプロジェクトステータス ソースコードはAGPL-3.0-onlyライセンスです。AGPLのコピーレフトおよびソース公開義務が果たされる場合に限り、個人、研究、教育、セルフホスト、および商用利用が許可されています。プライベートソースのプロプライエタリな利用には、別途商用またはブランディングの許可が必要です。パブリックデプロイメントとデスクトップバイナリは安定版として提供され、同一のバックログからメンテナンスされています。本プロジェクトはElie Habibによって作成され、CONTRIBUTINGガイドに従った貢献を歓迎しています。