---
hide:
  - navigation
  - toc
---

<p align="center">
  <img src="https://raw.githubusercontent.com/axm-protocols/axm-init/main/assets/logo.png" alt="AXM Logo" width="180" />
</p>

<p align="center">
  <strong>axm-bib — Bibliographic tools: search papers, resolve DOIs to BibTeX, download & extract open-access PDFs.</strong>
</p>

<p align="center">
  <a href="https://github.com/axm-protocols/axm-bib/actions/workflows/ci.yml"><img src="https://github.com/axm-protocols/axm-bib/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
  <a href="https://axm-protocols.github.io/axm-init/explanation/check-grades/"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/axm-protocols/axm-bib/gh-pages/badges/axm-init.json" alt="axm-init" /></a>
  <a href="https://axm-protocols.github.io/axm-audit/"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/axm-protocols/axm-bib/gh-pages/badges/axm-audit.json" alt="axm-audit" /></a>
  <a href="https://coveralls.io/github/axm-protocols/axm-bib?branch=main"><img src="https://coveralls.io/repos/github/axm-protocols/axm-bib/badge.svg?branch=main" alt="Coverage" /></a>
  <a href="https://pypi.org/project/axm-bib/"><img src="https://img.shields.io/pypi/v/axm-bib" alt="PyPI" /></a>
  <img src="https://img.shields.io/badge/python-3.12+-blue.svg" alt="Python 3.12+" />
  <img src="https://img.shields.io/badge/license-Apache%202.0-blue.svg" alt="License" />
</p>

---

## What is axm-bib?

`axm-bib` is a **CLI tool** and **Python library** for academic bibliography management. Use it from the command line, import it in your scripts, or let AI agents call it via MCP — all backed by the same pipeline. It unifies eight academic APIs into one interface:

| API | Purpose |
|---|---|
| **Semantic Scholar** | Search 200M+ papers by title/keywords |
| **CrossRef** | Resolve DOIs to BibTeX entries |
| **Unpaywall** | Find open-access PDF download links |
| **DBLP** | CS bibliography with native BibTeX (search fallback) |
| **OpenReview** | Conference paper discovery (NeurIPS, ICLR, ICML) |
| **arXiv** | Native BibTeX + Atom XML search + guaranteed OA PDFs |
| **OpenAlex** | Cross-referencing & identity linking (240M+ works) |
| **HAL** | French academic publications + native BibTeX (CNRS/CCSD) |

## Quick Example

```bash
$ axm-bib search "transformer architecture" -n 2

[1] Attention is All you Need
    Authors: Ashish Vaswani, Noam Shazeer, Niki Parmar et al.
    Year: 2017  DOI: arXiv:1706.03762
    The dominant sequence transduction models are based on complex recurrent...

[2] An Image is Worth 16x16 Words
    Authors: Alexey Dosovitskiy, Lucas Beyer et al.
    Year: 2020  DOI: 10.48550/arXiv.2010.11929
    We show that a pure transformer applied directly to sequences of image patches...
```

## Features

- 🔍 **Search** — Find papers by title/keywords with abstracts and citations (6-source fan-out with source visibility)
- 🏛️ **OpenReview** — Browse conference proceedings and generate BibTeX from forum metadata
- 📦 **arXiv** — Native BibTeX fetching and paper search with guaranteed open-access PDFs
- 🔗 **OpenAlex** — Cross-referencing 240M+ works: title → DOI, arXiv ID, MAG ID
- 🇫🇷 **HAL** — French academic publications (CNRS/CCSD) with native BibTeX
- 🎯 **Universal Resolver** — `axm-bib resolve` auto-detects DOI, arXiv, HAL, DBLP, or OpenReview (`openreview:ID` or URL) (ID-only, titles rejected)
- 🏷️ **Venue Enrichment** — arXiv entries auto-enriched with venue metadata from S2/DBLP
- 🔀 **Multi-Ref Merge** — Resolve multiple identifiers for the same paper into a single BibTeX entry with field merging, entry type promotion, and coherence check
- 📊 **Citation Graph** — S2 citations, references, recommendations + OpenAlex fallback
- 📥 **PDF Pipeline** — Download via multi-source URL chain (S2 OA → arXiv → Unpaywall → DOI fallbacks), accepts any identifier
- 📄 **Content Extraction** — PDF → Markdown + figure PNGs (PyMuPDF)
- 🪃 **OA Fallback** — Direct download from arXiv and ACL Anthology when Unpaywall has no URL
- 🪝 **Protocol Hook** — Automatically extract paper metadata for AXM protocol sessions
- 🤖 **MCP Integration** — Tools auto-discovered by `axm-mcp` for AI agent workflows
- ⚡ **Fast & Resilient** — Automatic retry with exponential backoff, strict mypy, comprehensive test suite

---

<div style="text-align: center; margin: 2rem 0;">
  <a href="tutorials/getting-started/" class="md-button md-button--primary">Get Started →</a>
  <a href="reference/cli/" class="md-button">CLI Reference</a>
</div>
