Metadata-Version: 2.4
Name: bibexpy
Version: 2.0.0
Summary: Self-hosted bibliometric data preparation tool (Scopus + Web of Science)
Author: Burak Can Kara, Alperen Şahin, Taşkın Dirsehan
License: GPL-3.0-or-later
Project-URL: Homepage, https://bibexpy.com
Project-URL: Repository, https://github.com/bcankara/BibexPy
Project-URL: Paper, https://doi.org/10.1016/j.softx.2025.102098
Keywords: bibliometrics,scientometrics,scopus,web of science,research
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Framework :: FastAPI
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastapi>=0.110.0
Requires-Dist: uvicorn[standard]>=0.27.0
Requires-Dist: python-multipart>=0.0.9
Requires-Dist: pydantic>=2.6.0
Requires-Dist: pydantic-settings>=2.2.0
Requires-Dist: sse-starlette>=2.0.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: openpyxl>=3.1.2
Requires-Dist: scikit-learn>=1.3.0
Requires-Dist: nltk>=3.8.1
Requires-Dist: requests>=2.31.0
Requires-Dist: urllib3>=2.0.0
Requires-Dist: certifi>=2023.5.7
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: tqdm>=4.65.0
Requires-Dist: colorama>=0.4.6
Requires-Dist: unidecode==1.3.6
Requires-Dist: typing-extensions>=4.7.0
Dynamic: license-file

<p align="center">
  <a href="https://bibexpy.com">
    <img src="https://raw.githubusercontent.com/bcankara/BibexPy/main/apps/web/public/images/bibexpy-logo-full.png" alt="BibexPy — V2.0.0 Helium — Bibliometrics Experience with Python" width="420">
  </a>
</p>

**Self-hosted, reproducible bibliometric data preparation for Web of Science & Scopus.**

BibexPy v2.0.0 **"Helium"** merges, filters, harmonizes, enriches and exports WoS + Scopus
records through a local web interface — with full provenance — and keeps your licensed
exports on your own machine. It prepares analysis-ready datasets for VOSviewer, Biblioshiny,
BibTeX, RIS, Excel and more.

## Install

```bash
pip install bibexpy
bibexpy            # launches the local web UI (browser opens automatically)
```

Requires **Python 3.10+** only — **no Node.js/npm needed** (the interface ships precompiled
inside the package). Works on Windows, macOS and Linux.

```bash
bibexpy --port 8080          # custom port
bibexpy --no-browser         # server only
bibexpy --storage ./data     # custom storage folder
bibexpy --version
```

Defaults: UI at `http://127.0.0.1:6060`, data under `~/.bibexpy/storage`, settings/API keys
under `~/.bibexpy/.env` (managed from the in-app Settings page). Press `Ctrl+C` to stop.

## Highlights (v2)

- One-click **Smart Merge** — probabilistic record linkage (DOI + Jaro–Winkler), confidence
  scoring, optional borderline review, and a copy-ready methodology paragraph.
- **ORCID-first** author disambiguation + **address harmonization** (organization roll-up,
  country standardization).
- **Multi-source enrichment** (CrossRef, OpenAlex, Scopus, DataCite, Unpaywall, Europe PMC,
  Semantic Scholar) with reverse-DOI recovery — verifiable sources only.
- Reproducible, preset-based **filtering** and a bibliometrically weighted **quality dashboard**.
- Full **provenance**: append-only audit log, snapshots, isolated analyses, auto-generated
  methodology narrative.
- Structured **export**: WoS, VOSviewer TSV, BibTeX, RIS, CSV, TSV, XLSX.

## Links

[Website](https://bibexpy.com) · [Docs](https://bibexpy.com/doc) ·
[GitHub](https://github.com/bcankara/BibexPy) · [Paper (SoftwareX)](https://doi.org/10.1016/j.softx.2025.102098)

## Citation

> Kara, B. C., Şahin, A., & Dirsehan, T. (2025). BibexPy: Harmonizing the bibliometric symphony
> of Scopus and Web of Science. *SoftwareX*, 30, 102098.
> https://doi.org/10.1016/j.softx.2025.102098

## License

GPL-3.0-or-later
