This release is a pre-release and may not be stable for production use.
PaperSeek
Open-source literature search, citation exploration, and abstract-based reviews.
PaperSeek turns a research question into a reading list. It plans and refines queries, retrieves papers from your chosen source, expands citations where supported, and ranks relevance. Explore the results in a bilingual Web workspace, save local history, and export a reading list.
Project overview · Documentation · 中文文档 · Try online
Install
Requires Python 3.12 or newer. The release package includes the Web UI.
python -m pip install "paperseek==1.0.0b4"
paperseek serve
Open http://127.0.0.1:8765. Configure a model API and data source in the application.
Capabilities
- Eight scholarly sources: OpenAlex, arXiv, Crossref, Semantic Scholar, PubMed, Google Scholar via Serper, PaperHub, and Web of Science Starter.
- Query iteration, bounded candidate retrieval, optional citation expansion, and relevance ranking.
- OpenAI Responses, OpenAI-compatible Chat Completions, and Anthropic Messages model protocols.
- Local fusion, Embedding + Rerank, or System One preliminary ranking.
- Search history, filters, selection, citation maps, and complete CSV/JSON exports.
- Experimental abstract-based reviews with editable outlines, section writing, versions, and Markdown/Word/BibTeX exports.
A run begins with one selected data source. Search is bounded, not guaranteed exhaustive; reviews use available abstracts and metadata rather than automatically read full texts.
Terminal and integrations
The CLI provides serve, worker, search, doctor, migrate, and version. Configure process environment variables before a terminal search; a nearby .env is not loaded automatically.
paperseek search "How does open-source funding affect maintenance?" --source openalex --search-budget medium --output json
The local HTTP API is under /api/v1, with its schema at /openapi.json. MCP is packaged separately:
python -m pip install "paperseek-mcp==1.0.0b4"
paperseek-mcp --transport stdio
Data and upgrades
Community stores history in ~/.paperseek/paperseek.db by default, with artifacts and credential-encryption material in its data directory. Back up the complete directory consistently.
For Docker, separate workers, and 0.2 migration, see self-hosting and upgrading.
Development and license
The source distribution uses paperseek_core for research behavior, paperseek_app for use cases and ports, and paperseek_community for local adapters. Hosted consumes a fixed Community distribution. Common Vue sources are included for Hosted builds; installed Community serves the prebuilt assets.
Metadata
Release files for paperseek 1.0.0b4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| paperseek-1.0.0b4-py3-none-any.whl | Python 3 | none | any | Details |
Release files / paperseek-1.0.0b4-py3-none-any.whl
| Download URL | paperseek-1.0.0b4-py3-none-any.whl |
|---|---|
| Size | 813.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e4d4b1884b53c6394fcbdbd7522bc3ed7cd208c9048399e5355eaf1a584a9eff
|
|
BLAKE2b-256 checksum How to use checksums |
2b809eaa580a6e76ce240815fb4603b602fe02f03171858aa03c5106fcd5c7c9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Security for paperseek 1.0.0b4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.