Paper Pilot

Der Forschungskopilot für Ihre KI.

Ihre KI googelt nur, wenn Sie "recherchieren" sagen. Paper Pilot durchsucht tatsächlich echte wissenschaftliche Datenbanken, lädt die PDFs herunter, liest sie von vorne bis hinten durch und liefert Ihnen Belege mit Zitaten.

Schnellstart

uvx paper-pilot

Das war's. Oder installieren Sie es:

pip install paper-pilot

Funktionsweise

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]

Ein Prompt. Sechs wissenschaftliche Datenbanken. Echte PDFs. Echte Zitate.

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

Ihre KI wird:

1. Semantic Scholar, OpenAlex, arXiv, Crossref und Europe PMC durchsuchen

2. Open-Access-PDFs finden, nicht nur Abstracts

3. Diese herunterladen und von vorne bis hinten lesen

4. Belegabschnitte mit Quellenangaben extrahieren

5. Bestimmte Seiten rendern, damit sie die Abbildungen und Tabellen sehen kann

6. Einen strukturierten Markdown-Bericht schreiben

7. Alles in Ihrer Zotero-Bibliothek speichern

Im Vergleich zu Alternativen

MCP-Client-Einrichtung

Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "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

Fügen Sie dies zu ~/.codex/config.toml hinzu:

[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"

Streambarer HTTP-Modus

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

Tools

Sci-Hub-Integration (Opt-in)

Der Zugriff auf Sci-Hub ist standardmäßig deaktiviert. Um ihn zu aktivieren:

SCIHUB_ENABLED=true

Sobald aktiviert, verwenden Sie search_scihub und download_scihub_paper direkt oder übergeben Sie include_scihub=True an research_topic / deep_read_topic für ein automatisches Fallback.

Haftungsausschluss: Die Sci-Hub-Integration wird ausschließlich für Bildungs- und Forschungszwecke bereitgestellt. Die Nutzer sind allein für die Einhaltung geltender Gesetze und institutioneller Richtlinien verantwortlich.

Wer nutzt das

Doktoranden, die keine Woche mit einer Literaturrecherche verbringen wollen. Geben Sie Ihr Dissertationsthema ein und erhalten Sie einen strukturierten Vergleich mit echten Zitaten und den PDFs bereits in Zotero.

Forschungslabore, die wöchentlich Preprints scannen und automatisch ablegen möchten. Führen Sie research_topic nach Zeitplan aus und halten Sie Ihre Gruppenbibliothek aktuell.

KI-Entwickler, deren Agenten mit echten wissenschaftlichen Arbeiten arbeiten müssen, anstatt nur Web-Schnipsel zu scrapen.

Konfiguration

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=

Projektstruktur

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

Architekturdetails: docs/ARCHITECTURE.md

Für KI-Agenten

• AGENTS.md -- gemeinsamer Leitfaden für den Betrieb

• CLAUDE.md -- Einrichtung für Claude Desktop und Claude Code

• CODEX.md -- Einrichtung für Codex

• docs/CLIENTS.md -- Client-Vergleich im direkten Gegenüber

Mitwirken

Pull Requests sind willkommen. Die wirkungsvollsten Bereiche:

• Neue Adapter für wissenschaftliche Quellen

• Bessere Logik zur OA-Auflösung

• Verbesserungen bei der PDF-Analyse

• Weitere MCP-Client-Konfigurationen

Siehe CONTRIBUTING.md.

Haftungsausschluss

Dieses Tool ist ausschließlich für akademische Forschung und Bildungszwecke konzipiert. Open-Access-Funktionen nutzen nur legale, öffentlich zugängliche Quellen. Sci-Hub- und LibGen-Integrationen sind standardmäßig deaktiviert und werden als optionale Funktionen bereitgestellt.

Lizenz

MIT. Machen Sie damit, was Sie wollen.

Wenn dies Ihre Forschung unterstützt, geben Sie dem Repo einen Stern und erzählen Sie einem Kollegen davon.