Настройка: уведомления, ключ ИИ и своя копия

Где находятся настройки

Откройте репозиторий на GitHub → Settings → Secrets and variables → Actions. Там две вкладки:

• Secrets — скрытые значения (токены, ключи). Прочитать их обратно нельзя даже владельцу, в логах они замаскированы.
• Variables — обычные несекретные значения (код языка, название модели).

Изменения действуют со следующего запуска. Запустить сразу: Actions → research-agents → Run workflow.

Уведомления в Telegram

Агенты пишут вам, когда происходит что-то важное: сменился режим рынка, правило H-020 вошло в рынок или вышло, у гипотезы новый вердикт, сломался источник данных, и раз в неделю — сводка.

1. В Telegram откройте @BotFather. Возьмите существующего бота (/mybots → бот → API Token) или создайте нового командой /newbot.
2. Откройте своего бота и нажмите Start, иначе ему нельзя писать вам.
3. Узнайте свой ID: напишите @userinfobot, он ответит числом вроде 123456789. Для группы или канала добавьте туда бота, их ID начинаются с -100.
4. В Settings → Secrets and variables → Actions → Secrets → New repository secret создайте TELEGRAM_BOT_TOKEN (токен) и TELEGRAM_CHAT_ID (ID).
5. Язык: во вкладке Variables → New repository variable создайте TELEGRAM_LANG со значением ru (или en, es, pt, tr, vi, zh). Без неё уведомления на английском. В конце каждого уведомления — ссылка на дашборд на том же языке.
6. Проверка: Actions → research-agents → Run workflow, отметьте test_alert и запустите. Через несколько минут придёт «уведомления в Telegram подключены». Если шаг упал — неверный токен или ID, либо бот не запущен.

Уведомления приходят только при изменениях, в спокойные дни их нет.

Ключ ИИ-модели (необязательно)

Все проверки делает движок по заранее зафиксированным правилам: модель никогда не решает, работает ли идея. Ключ модели добавляет двух помощников:

• Недельная сводка простыми словами. Без ключа приходят сырые недельные отчёты на английском. С ключом модель пересказывает их коротко на языке из TELEGRAM_LANG, только по цифрам из отчётов и без торговых советов.
• Черновики новых гипотез раз в месяц (1-го числа). Модель смотрит, что уже проверено, и предлагает идеи пулл-реквестом в статусе draft. Регистрировать или нет — решаете вы; без регистрации ничего не проверяется.

Бесплатный вариант: Groq. Зарегистрируйтесь на console.groq.com → API Keys → Create API Key и сохраните ключ как секрет LLM_API_KEY. Платить не нужно: у бесплатного тарифа дневные лимиты, для недельной сводки их с запасом. Модель выбирается автоматически из бесплатных моделей, которые Groq сейчас предлагает (их переименовывают и убирают); чтобы закрепить конкретную, задайте CRL_LLM_MODEL. Подойдёт и любой другой OpenAI-совместимый сервис (OpenRouter, Gemini): укажите его адрес в переменной CRL_LLM_BASE_URL. Если заданы оба ключа, используется LLM_API_KEY.

Как подключить Anthropic (платно):

1. Зайдите на console.anthropic.com, зарегистрируйтесь и пополните баланс в разделе Billing. API оплачивается по факту использования и отдельно от подписки Claude. Недельная сводка и ежемесячные предложения стоят центы в месяц. Заранее проверьте, что ваша страна есть в списке поддерживаемых регионов Anthropic.
2. API Keys → Create Key, скопируйте ключ (sk-ant-…). Он показывается один раз.
3. В Settings → Secrets and variables → Actions → Secrets создайте ANTHROPIC_API_KEY с этим ключом.
4. Необязательно: переменная CRL_LLM_MODEL, чтобы выбрать другую модель (по умолчанию claude-sonnet-5-5).
5. Чтобы черновики приходили пулл-реквестами: Settings → Actions → General → Allow GitHub Actions to create and approve pull requests.

Чтобы выключить — удалите секрет. Если ключ утёк, сразу отзовите его в консоли.

Своя копия проекта

Всё работает на бесплатных серверах GitHub, на вашем компьютере ничего не нужно.

1. Откройте https://github.com/f1devbin/Crypto-Research-Labs и нажмите Fork.
2. В своей копии: Settings → Pages → Source: GitHub Actions.
3. Actions → включите workflows, если попросит → research-agents → Run workflow. Первый запуск идёт около 20 минут (загружается история цен). Дальше всё работает само каждый день.
4. Ваш дашборд появится по адресу https://<ваш-ник>.github.io/Crypto-Research-Labs/.
5. По желанию подключите Telegram и ключ ИИ, как описано выше.

Свою идею можно предложить через CONTRIBUTING.md или в Discussions → Ideas.

Все настройки одной таблицей