DblpService

DBLP build-and-query backend service.

[EN] | [CN]

Overview

DblpService is a reusable DBLP backend for data bootstrap, SQLite build, and query serving. It can be integrated by CoAuthors, CiteVerifier, and other systems that need local DBLP data services.

Core Capabilities

• DBLP source download and parsing pipeline.
• Bootstrap control console (/bootstrap).
• Query APIs (/api/health, /api/stats, /api/coauthors/pairs).
• Pipeline lifecycle APIs (/api/start, /api/stop, /api/reset, /api/state).

Quick Start

cd DblpService
python -m pip install -r requirements.txt
python -m uvicorn app:app --host 0.0.0.0 --port 8091

Open:

• http://localhost:8091/bootstrap
• http://localhost:8091/

Key Environment Variables

• DATA_DIR (default: ./data)
• DB_PATH (default: ${DATA_DIR}/dblp.sqlite)
• CORS_ORIGINS (comma-separated origins)
• DB_BUSY_TIMEOUT_MS (default: 30000)

Documentation

• English docs: https://dblpservice.readthedocs.io/en/latest/
• Docs source (in repo): docs/en/, docs/zh/

Local preview:

cd DblpService
python -m pip install -r docs/requirements.txt
mkdocs serve