SciPaperlib

A local research library for collecting publications and retrieving inspectable, revision-bound evidence. No LLM, embedding service, or API key is required.

The distribution and Python import name are scipaperlib. Commands scipaperlib and spl are equivalent; spl-tui launches spl --tui.

python -m pip install scipaperlib
scipaperlib demo ./demo-library
scipaperlib search --library ./demo-library --term mass --term "energy loss" --json
scipaperlib tui --library ./demo-library

Libraries are selected by name: spl-tui --name "heavy ion papers" uses a registered location, or creates ~/.scipaperlib/heavy_ion_papers_scipaperlib after confirmation. With no name, the library is default, stored initially at ~/.scipaperlib/default_scipaperlib. Set SCIPAPERLIB_DATADIR to change the parent directory for new libraries.

spl --list shows known libraries. Register an existing directory with spl --add-library /path/to/library --name "heavy ion papers". The registry lives at ~/.scipaperlib/config.json; SCIPAPERLIB_CONFIG overrides that file path. Registered locations remain stable when the data directory changes. Use --library PATH for an explicit location instead of --name. Scripts can pass --init-library to create a missing library without prompting.

A fixed TUI activity panel shows progress and outcomes; CLI progress goes to stderr. The TUI prevents overlapping write operations and supports stopping imports after the current request.

Add papers from the TUI's paste area and remove a selected paper with confirmation. The CLI equivalent is spl remove PAPER_ID; removal archives files by default, while --delete-files permanently deletes them.

The Textual TUI is installed by default. Optional extras pdf and mcp add PDF extraction and the MCP server. The tui extra remains accepted for compatibility. See the guide for imports, provenance, recovery, and agent access.

Check for application updates with spl --check-upgrade; install an update with spl --upgrade, then restart SciPaperlib. Both accept --json and work through spl-tui without launching the TUI. Upgrades target the Python environment running the command; editable development installs are protected. This is separate from spl update, which updates papers.

Project links

Data verified by PyPI on Sep 6, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.4)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for matplo from gravatar.com matplo

Credits

Author/Maintainer: matplo

GitHub Statistics

Data verified by PyPI on Sep 6, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Provides Extra

dev mcp pdf tui

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scipaperlib-0.1.2.tar.gz (100.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

scipaperlib-0.1.2-py3-none-any.whl (74.5 kB view details)

Uploaded Python 3

File details

Details for the file scipaperlib-0.1.2.tar.gz.

File metadata

  • Download URL: scipaperlib-0.1.2.tar.gz
  • Upload date:
  • Size: 100.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for scipaperlib-0.1.2.tar.gz
Algorithm Hash digest
SHA256 380722d033ee4cfb8699bc48a84808b57ebcc698abd32e846b0f93260355bcae
MD5 80210e64dc362ff28fe38ba9839d9dbe
BLAKE2b-256 f5cb3619fe2c89e82ebe9ce80d73104fd99ba9559c8c31f577bbed723ba9d3b3

See more details on using hashes here.

Provenance

The following attestation bundles were made for scipaperlib-0.1.2.tar.gz:

Publisher: pypi.yml on matplo/scipaperlib

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file scipaperlib-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: scipaperlib-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 74.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for scipaperlib-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 e9eedb5d1239304ebee5e952c070951e101dfe57a4d779d6c5793b81e0dfd391
MD5 f67c47bcb4423ece4753ec4f1aeb4843
BLAKE2b-256 88030de5f58388e62e207c42731297fa29100974e3c6d6426a5c239e5f12eba7

See more details on using hashes here.

Provenance

The following attestation bundles were made for scipaperlib-0.1.2-py3-none-any.whl:

Publisher: pypi.yml on matplo/scipaperlib

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.1.4

2 files

0.1.3

2 files

This release

0.1.2 This release

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page