Об этом проекте

## Что это такое World Monitor — это глобальный дашборд разведки в реальном времени, который объединяет агрегацию новостей на базе ИИ, геополитический мониторинг и отслеживание инфраструктуры в едином интерфейсе ситуационной осведомленности. Он построен на единой кодовой базе, которая поддерживает несколько вариантов сайта: world, tech, finance, commodity, happy и energy. ## Документированные возможности - Курируемые новостные ленты по глобальным и региональным категориям, синтезируемые ИИ в краткие сводки. - Двойной картографический движок: 3D-глобус на базе globe.gl и плоская WebGL-карта на базе deck.gl с общим каталогом слоев карты. - Инвентарь панелей с конкретными реализациями для специализированных вариантов. - Кросс-потоковая корреляция военных, экономических, катастрофических сигналов и сигналов эскалации. - Индекс нестабильности стран (Country Instability Index, CII): живые показатели CII v8, диапазоны и приблизительное 24-часовое движение для 31 страны первого уровня. - Финансовый радар, охватывающий фондовые биржи, сырьевые товары, криптовалюты и рыночный композит. - Локальная работа ИИ через Ollama без необходимости в API-ключах; также поддерживаются Groq, OpenRouter и браузерная библиотека Transformers.js. - Нативное десктопное приложение (Tauri 2) для macOS (Apple Silicon и Intel), Windows и Linux AppImage. Один бинарный файл охватывает все варианты с возможностью переключения внутри приложения. - Многоязычный интерфейс с лентами на родных языках и поддержкой RTL. ## Запуск Документированный быстрый старт предполагает клонирование репозитория, выполнение `npm install` и `npm run dev`, затем открытие localhost:3000 (порт можно изменить с помощью `DEV_PORT`). Сообщается, что приложение работает без переменных окружения, хотя для специфических источников данных могут потребоваться учетные данные, указанные в `.env.example`. Существуют скрипты разработки для конкретных вариантов (`dev:tech`, `dev:finance`, `dev:commodity`, `dev:happy`, `dev:energy`). Варианты селф-хостинга включают Vercel, Docker и статическое развертывание. ## Программный доступ Помимо браузерного интерфейса, проект документирует: - MCP-сервер по адресу `https://worldmonitor.app/mcp` (Streamable HTTP) с публичным `tools/list` и аутентифицированным `tools/call`, а также навыки агентов (Agent Skills), опубликованные через черновик расширения MCP skills. - REST API по адресу `https://api.worldmonitor.app`, описанный спецификацией OpenAPI. - Официальный npm CLI `worldmonitor`, запускаемый ad hoc через `npx` или устанавливаемый глобально как `worldmonitor` / `wm`. - Официальные SDK без зависимостей для Python (`worldmonitor-sdk`), Ruby и Go. Также опубликованы файлы обнаружения агентов, такие как `llms.txt`, манифест навыков агента и каталог API. ## Технологический стек В README указаны vanilla TypeScript и Vite для фронтенда; Tauri 2 (Rust) с Node.js sidecar для десктопа; Ollama, Groq, OpenRouter и Transformers.js для ИИ; Protocol Buffers и HTTP-аннотации sebuf для контрактов API; Vercel Edge Functions, реле Railway, Tauri и PWA для развертывания; а также Redis (Upstash) с трехслойным кэшем, CDN и service worker для кэширования. ## Источники данных и атрибуция Данные агрегируются из указанных вышестоящих провайдеров в областях геополитики, финансов, энергетики, климата, авиации, кибербезопасности, военного дела, инфраструктуры и новостной разведки. Данные о полетах предоставлены Wingbits. Каталог источников данных содержит информацию о провайдере, уровне ленты, лицензионном статусе и методе сбора. ## Лицензирование и статус проекта Исходный код распространяется под лицензией AGPL-3.0-only; личное, исследовательское, образовательное, селф-хостинг и коммерческое использование разрешены при соблюдении обязательств AGPL по копилефту и доступности исходного кода. Для проприетарного использования с закрытым кодом требуется отдельное коммерческое разрешение или разрешение на брендинг. Публичные развертывания и десктопные бинарные файлы считаются стабильными и поддерживаются из общего бэклога. Автор проекта — Elie Habib; проект приветствует вклад в соответствии с руководством CONTRIBUTING.