프로젝트 소개

## 개요 World Monitor는 AI 기반 뉴스 집계, 지정학적 모니터링 및 인프라 추적을 하나의 상황 인식 인터페이스로 결합한 실시간 글로벌 인텔리전스 대시보드입니다. 단일 코드베이스로 구축되었으며 world, tech, finance, commodity, happy, energy 등 여러 사이트 변형 버전을 제공합니다. ## 주요 기능 - 글로벌 및 지역 카테고리별 큐레이션 뉴스 피드를 AI가 요약하여 제공합니다. - globe.gl로 구축된 3D 글로브와 deck.gl로 구축된 WebGL 평면 맵의 듀얼 맵 엔진을 갖추고 있으며, 맵 레이어 카탈로그를 공유합니다. - 전문화된 변형 버전 전반에 걸쳐 구체적인 패널 구현체가 포함된 패널 인벤토리를 제공합니다. - 군사, 경제, 재난 및 갈등 고조 신호 간의 교차 스트림 상관관계를 분석합니다. - 국가 불안정 지수(CII): 31개 Tier-1 국가에 대한 실시간 CII v8 점수, 밴드 및 약 24시간 동안의 변동 추이를 제공합니다. - 증권 거래소, 원자재, 암호화폐 및 시장 종합 지수를 포함하는 금융 레이더를 제공합니다. - Ollama를 통해 API 키 없이 로컬 AI를 운영할 수 있으며, 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` (Streamable HTTP)의 MCP 서버: 공개 `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 카탈로그와 같은 에이전트 검색 파일이 게시되어 있습니다. ## 기술 스택 프론트엔드는 vanilla TypeScript와 Vite를 사용하며, 데스크톱 앱은 Tauri 2(Rust)와 Node.js 사이드카를 사용합니다. AI는 Ollama, Groq, OpenRouter 및 Transformers.js를 활용합니다. API 계약에는 Protocol Buffers와 sebuf HTTP 어노테이션이 사용되었습니다. 배포에는 Vercel Edge Functions, Railway 릴레이, Tauri 및 PWA가 사용되며, 캐싱을 위해 3계층 캐시, CDN, 서비스 워커와 함께 Redis(Upstash)를 사용합니다. ## 데이터 소스 및 출처 데이터는 지정학, 금융, 에너지, 기후, 항공, 사이버, 군사, 인프라 및 뉴스 인텔리전스 분야의 출처가 명시된 업스트림 제공업체로부터 집계됩니다. 항공 데이터는 Wingbits의 제공을 받습니다. 데이터 소스 카탈로그에는 제공업체, 피드 티어, 라이선스 상태 및 수집 방법이 기록되어 있습니다. ## 라이선스 및 프로젝트 상태 소스 코드는 AGPL-3.0-only 라이선스를 따릅니다. AGPL 카피레프트 및 소스 공개 의무를 준수하는 경우 개인, 연구, 교육, 셀프 호스팅 및 상업적 이용이 허용되며, 비공개 소스 전용 사용을 위한 별도의 상업적 또는 브랜딩 허가가 필요합니다. 공개 배포 및 데스크톱 바이너리는 안정적인 상태로 동일한 백로그에서 유지 관리됩니다. 이 프로젝트는 Elie Habib이 작성했으며, CONTRIBUTING 가이드에 따른 기여를 환영합니다.