📘 README.md — Rhythm Engine

Rhythm Engine — минимальная, воспроизводимая система, которая измеряет ритмы Планеты №3: новости, регуляции, макроэкономику, крипту, погоду, космическую погоду, психологию толпы и on‑chain активность.

Она собирает данные → нормализует → коррелирует → интерпретирует → отправляет.

🧩 Архитектура

/sensors news.py crypto_news.py regulation.py macro.py tech.py sentiment.py magnetic_storm.py weather.py onchain.py dex.py

runtime.py correlator.py interpreter.py postman.py scheduler.py

/data signals.jsonl correlated.jsonl interpretations.jsonl postman_log.jsonl

⚙️ Как работает система

1. Сенсоры Каждый сенсор — это один файл, одна функция collect(), один JSON‑объект. Они тянут данные из первичных источников:

• Новости — Reuters, AP, BBC

• Крипто‑новости — CoinDesk, CoinTelegraph

• Регуляции — Reuters Legal, CoinDesk Policy

• Макро — MarketWatch, Yahoo Finance

• Технологии — TechCrunch, Wired

• Психология толпы — Reddit, Hacker News, Google Trends

• Магнитные бури — NOAA

• Погода — OpenWeather

• On‑chain — TON, ETH, BTC

• DEX‑ликвидность — DexScreener

Каждый сенсор возвращает:

{ "timestamp_utc": "...", "local_time": "...", "region": "US", "source": "reuters", "sensor": "news", "category": "geopolitics", "intensity": 0.42, "raw_value": {...} }

Все сенсоры пишут в data/signals.jsonl.

🧠 Коррелятор correlator.py:

читает последние 60 минут сигналов

применяет веса сенсоров

суммирует weighted‑intensity

нормализует в диапазон 0–1

выбирает топ‑3 источника

пишет итог в data/correlated.jsonl

Это мозг системы.

🎙 Интерпретатор interpreter.py:

берёт последний итоговый ритм

определяет тон (спокойный → тревожный → красная зона)

создаёт текстовое объяснение

пишет в data/interpretations.jsonl

Это голос системы.

📮 Postman postman.py:

берёт последний текст интерпретатора

отправляет в Telegram

пишет лог отправки

Это канал связи.

⏰ Scheduler scheduler.py:

запускает всю цепочку (MSK)

runtime → correlator → interpreter → postman

работает в вечном цикле

Это ритуал системы.

🚀 Запуск

1. Установить зависимости

pip install feedparser requests pytz

2. Создать папку данных

mkdir data

3. Запустить runtime вручную

python runtime.py

4. Запустить коррелятор

python correlator.py

5. Запустить интерпретатор

python interpreter.py

6. Запустить отправку

python postman.py

7. Запустить расписание

python scheduler.py

🧱 Принципы системы Минимализм — каждый файл делает одну вещь.

Прозрачность — никакой магии, только чистые данные.

Воспроизводимость — всё можно запустить на любом сервере.

Чистота — никакого ML, только логика.

Ритм — система измеряет не факты, а динамику.

📡 Философия Мир — это не набор событий. Мир — это ритм.

Rhythm Engine — это инструмент, который слышит этот ритм.