Secondary Hipsters

🎯 Что делает этот инструмент

Вы нашли перспективную ML-статью. Но сможет ли ваша команда её воспроизвести?

R&D Risk Analyst отвечает на этот вопрос, анализируя статьи по 6 критическим направлениям и выдавая обоснованный вердикт:

✨ Возможности

• 🔗 Мульти-источниковый поиск — Поддержка arXiv URL, arXiv ID и DOI
• 🤖 Анализ на базе LLM — LangChain + OpenRouter (Claude, GPT-4, Gemini и другие)
• 📡 Автоматический сбор данных — Сканирование PDF, GitHub-репозиториев и API метаданных
• 🎯 Прозрачная логика решений — Каждая рекомендация подкреплена конкретными доказательствами
• 📋 Множество форматов вывода — Rich-терминал, Markdown-отчёты или JSON-экспорт
• 🌐 Веб-интерфейс — Streamlit UI с отслеживанием прогресса в реальном времени
• 🐳 Деплой одной командой — Docker Compose для мгновенного запуска
• ⚙️ Учёт ограничений — Укажите свои GPU/инфраструктурные лимиты для точного анализа

🚀 Быстрый старт

Вариант 1: Живое демо (самый простой)

👉 rnd-risk-analyst.camp.aitalenthub.ru

Никаких настроек — просто вставьте ссылку на arXiv и получите результат!

Вариант 2: Docker (свой сервер)

# Клонировать репозиторий
git clone https://github.com/AI-Talent-Camp-2026/research-assistant.git
cd research-assistant

# Указать API-ключ
echo "OPENROUTER_API_KEY=your-key-here" > .env

# Запустить
docker-compose up -d

# Открыть http://localhost:3000

Вариант 3: Локальная разработка

# Установить uv (быстрый пакетный менеджер Python)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Настроить окружение
uv venv && source .venv/bin/activate
uv pip install -e .

# Запустить веб-интерфейс
streamlit run app.py --server.port 3000

# Или использовать CLI
rnd-risk-analyst analyze 2301.07041 --verbose

Примеры использования CLI

# Анализ по arXiv ID
rnd-risk-analyst analyze 2301.07041 --verbose

# Анализ по URL
rnd-risk-analyst analyze "https://arxiv.org/abs/2301.07041"

# Анализ по DOI
rnd-risk-analyst analyze "10.1038/nature12373"

# Экспорт в markdown
rnd-risk-analyst analyze 2301.07041 --format markdown --output report.md

# С учётом ограничений команды
rnd-risk-analyst analyze 2301.07041 --constraints constraints.json

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

Логика принятия решений

⚙️ Конфигурация

Переменные окружения

# Обязательно
OPENROUTER_API_KEY=sk-or-v1-...      # Доступ к LLM через OpenRouter

# Опционально
LLM_MODEL=anthropic/claude-sonnet-4-20250514   # Модель по умолчанию
GITHUB_TOKEN=ghp_...                  # Повышенные лимиты GitHub API (60→5000/час)

🛠 Технологический стек

📊 Статистика проекта

📁 Структура проекта

research-assistant/
├── app.py                        # Streamlit веб-интерфейс
├── Dockerfile                    # Образ контейнера
├── docker-compose.yml            # Деплой одной командой
├── .github/workflows/
│   └── deploy.yml                # CI/CD пайплайн
├── src/rnd_risk_analyst/         # Основной пакет
│   ├── main.py                   # Точка входа CLI
│   ├── config.py                 # Настройки
│   ├── commands/
│   │   ├── analyze.py            # Пайплайн анализа
│   │   └── export.py             # Утилиты экспорта
│   ├── analysis/
│   │   ├── paper_fetcher.py      # Получение статей arXiv/DOI
│   │   ├── pdf_processor.py      # Обработка PDF
│   │   ├── github_analyzer.py    # Анализ репозиториев
│   │   ├── risk_assessor.py      # Извлечение рисков через LLM
│   │   ├── decision_engine.py    # Логика GO/CAUTIOUS/NO-GO
│   │   └── prompts.py            # Промпты для LLM
│   └── models/
│       ├── paper.py              # Метаданные статьи
│       ├── risk_signal.py        # Сигналы рисков
│       ├── report.py             # Отчёт о воспроизводимости
│       └── constraints.py        # Ограничения пользователя
├── tests/                        # Юнит- и интеграционные тесты
├── specs/                        # Спецификации фич
└── docs/                         # Исследования и продуктовые доки

👥 Команда

💬 Обратная связь

Есть идеи, нашли баг или хотите поделиться опытом?

• Telegram: @Ione_Golov
• GitHub Issues: Создать issue