Metadata-Version: 2.4
Name: bibmeded
Version: 0.4.0
Summary: Open-source bibliometric analysis platform and CLI for medical education research
Author: Ata Akillioglu
License-Expression: MIT
Project-URL: Homepage, https://ata381.github.io/BibMedEd/
Project-URL: Documentation, https://ata381.github.io/BibMedEd/
Project-URL: Source, https://github.com/ata381/BibMedEd
Project-URL: Issues, https://github.com/ata381/BibMedEd/issues
Project-URL: Changelog, https://github.com/ata381/BibMedEd/blob/master/CHANGELOG.md
Keywords: bibliometrics,scientometrics,medical education,pubmed,openalex,literature review,citation analysis
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Education
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: sqlalchemy>=2.0.0
Requires-Dist: pydantic-settings>=2.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: lxml>=5.0.0
Requires-Dist: networkx>=3.0.0
Requires-Dist: numpy>=1.26.0
Requires-Dist: scipy>=1.11.0
Provides-Extra: server
Requires-Dist: fastapi>=0.115.0; extra == "server"
Requires-Dist: uvicorn[standard]>=0.30.0; extra == "server"
Requires-Dist: alembic>=1.13.0; extra == "server"
Requires-Dist: psycopg2-binary>=2.9.0; extra == "server"
Requires-Dist: redis>=5.0.0; extra == "server"
Requires-Dist: celery[redis]>=5.4.0; extra == "server"
Provides-Extra: dev
Requires-Dist: bibmeded[server]; extra == "dev"
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.24.0; extra == "dev"
Requires-Dist: httpx>=0.27.0; extra == "dev"
Requires-Dist: factory-boy>=3.3.0; extra == "dev"
Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
Provides-Extra: docs
Requires-Dist: mkdocs-material>=9.0.0; extra == "docs"
Dynamic: license-file

# BibMedEd

Open-source bibliometric analysis for medical education research. Search PubMed,
OpenAlex, Crossref, Semantic Scholar and Lens, deduplicate across sources, and
analyse publications, authors, countries and collaboration networks.

This package installs the `bibmeded` command line tool and the Python library.
The full web application (Next.js UI, API, task workers) is self-hosted with Docker.

## Install

```bash
pip install bibmeded            # CLI + library, no server dependencies
pip install "bibmeded[server]"  # adds FastAPI, Celery, Redis, Postgres driver
```

Requires Python 3.12 or newer.

## Usage

```bash
# Estimate how many records a query matches (no database or worker needed)
bibmeded search "machine learning" --source openalex --dry-run
```

Fetching and storing records (`bibmeded search` without `--dry-run`) needs the
task worker stack: install the `server` extra and run Redis, a database and a
Celery worker, or simply use `docker compose up` from the repository.

## Links

- Documentation: https://ata381.github.io/BibMedEd/
- Source and issues: https://github.com/ata381/BibMedEd
- Changelog: https://github.com/ata381/BibMedEd/blob/master/CHANGELOG.md

Licensed under MIT.
