Paper Pilot

Ваш ИИ-копилот для научных исследований.

Когда вы говорите «исследуй», ваш ИИ просто гуглит. Paper Pilot по-настоящему ищет по реальным академическим базам данных, скачивает PDF-файлы, читает их от корки до корки и предоставляет вам доказательства со ссылками на источники.

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

uvx paper-pilot

Это всё. Или установите его:

pip install paper-pilot

Как это работает

graph LR
    A[Prompt] --> B[Search 6 databases]
    B --> C[Resolve OA PDFs]
    C --> D[Download & read]
    D --> E[Extract evidence]
    E --> F[Render figures]
    F --> G[Markdown report]
    G --> H[Zotero sync]

Один запрос. Шесть академических баз данных. Реальные PDF-файлы. Реальные цитирования.

Research retrieval-augmented generation, deep-read the top papers, and compare the methods.

Ваш ИИ будет:

1. Искать в Semantic Scholar, OpenAlex, arXiv, Crossref и Europe PMC

2. Находить PDF-файлы в открытом доступе, а не только аннотации

3. Скачивать и читать их от корки до корки

4. Извлекать фрагменты доказательств с указанием источника

5. Рендерить конкретные страницы, чтобы он мог видеть графики и таблицы

6. Писать структурированный отчет в формате Markdown

7. Сохранять всё в вашу библиотеку Zotero

Сравнение с аналогами

Настройка клиента MCP

Claude Desktop

Добавьте в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "paper-pilot": {
      "command": "uv",
      "args": ["--directory", "/path/to/paper-pilot", "run", "paper-pilot"],
      "env": {
        "OPENALEX_EMAIL": "you@example.com",
        "UNPAYWALL_EMAIL": "you@example.com",
        "ZOTERO_LOCAL": "true",
        "SCIHUB_ENABLED": "false"
      }
    }
  }
}

Claude Code

claude mcp add --scope user paper-pilot -- uv --directory /path/to/paper-pilot run paper-pilot

Codex

Добавьте в ~/.codex/config.toml:

[mcp_servers.paper_pilot]
command = "uv"
args = ["--directory", "/path/to/paper-pilot", "run", "paper-pilot"]

[mcp_servers.paper_pilot.env]
OPENALEX_EMAIL = "you@example.com"
ZOTERO_LOCAL = "true"

Потоковый HTTP-режим

paper-pilot --transport streamable-http --host 127.0.0.1 --port 8000

Инструменты

Интеграция со Sci-Hub (по выбору)

Доступ к Sci-Hub отключен по умолчанию. Чтобы включить его:

SCIHUB_ENABLED=true

После включения используйте search_scihub и download_scihub_paper напрямую или передайте include_scihub=True в research_topic / deep_read_topic для автоматического резервного поиска.

Отказ от ответственности: Интеграция со Sci-Hub предоставляется исключительно в образовательных и исследовательских целях. Пользователи несут единоличную ответственность за соблюдение применимых законов и политик своих организаций.

Кто этим пользуется

Аспиранты, которые не хотят тратить неделю на обзор литературы. Укажите тему диссертации и получите структурированное сравнение с реальными цитатами и PDF-файлами, уже добавленными в Zotero.

Научные лаборатории, которым нужно еженедельно сканировать препринты и автоматически их архивировать. Запускайте research_topic по расписанию и поддерживайте актуальность групповой библиотеки.

Разработчики ИИ, которым нужно, чтобы их агенты работали с реальными научными статьями, а не с фрагментами веб-страниц.

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

OPENALEX_EMAIL=you@example.com        # Required for polite API access
UNPAYWALL_EMAIL=you@example.com       # Required for OA resolution
SEMANTIC_SCHOLAR_API_KEY=             # Optional, higher rate limits

# Local Zotero
ZOTERO_LOCAL=true
ZOTERO_LIBRARY_TYPE=user

# Web Zotero API (alternative)
ZOTERO_LIBRARY_ID=
ZOTERO_API_KEY=

# Sci-Hub (disabled by default)
SCIHUB_ENABLED=false

# Storage
PAPER_PILOT_DATA_DIR=./data

# Institutional networks
HTTP_PROXY=
HTTPS_PROXY=
SSL_CERT_FILE=

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

src/paper_pilot/
  server.py              MCP tools and pipeline orchestration
  config.py              Environment and settings
  services/
    academic.py          Multi-source scholarly search
    open_access.py       OA resolution and PDF downloads
    scihub.py            Sci-Hub paper resolution (opt-in)
    deep_read.py         Full-text extraction and page rendering
    zotero.py            Local and web Zotero integration
    reporting.py         Markdown report generation
    libgen.py            Supplementary LibGen support

Детали архитектуры: docs/ARCHITECTURE.md

Для ИИ-агентов

• AGENTS.md — общее руководство по работе

• CLAUDE.md — настройка Claude Desktop и Claude Code

• CODEX.md — настройка Codex

• docs/CLIENTS.md — сравнение клиентов

Вклад в проект

Приветствуются PR. Наиболее важные области:

• Новые адаптеры для научных источников

• Улучшенная логика поиска OA

• Улучшения парсинга PDF

• Больше конфигураций для MCP-клиентов

См. CONTRIBUTING.md.

Отказ от ответственности

Этот инструмент предназначен только для академических исследований и образовательных целей. Функции открытого доступа используют только легальные, общедоступные источники. Интеграции со Sci-Hub и LibGen отключены по умолчанию и предоставляются как дополнительные функции по выбору пользователя.

Лицензия

MIT. Делайте с этим что хотите.

Если это помогло вашему исследованию, поставьте звезду репозиторию и расскажите коллеге.