---
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 tasks. It wraps three major APIs into a single, consistent interface:

| API | Purpose |
|---|---|
| **Semantic Scholar** | Search 200M+ papers by title/keywords |
| **CrossRef** | Resolve DOIs to BibTeX entries |
| **Unpaywall** | Find open-access PDF download links |

## 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
- 📖 **DOI → BibTeX** — Resolve any DOI to a ready-to-use BibTeX entry
- 📥 **PDF Pipeline** — Download, extract, and organize papers in one command
- 📄 **Content Extraction** — PDF → Markdown + figure PNGs (PyMuPDF)
- 🪃 **arXiv Fallback** — Direct download from arXiv when Unpaywall has no URL
- 🤖 **MCP Integration** — Tools auto-discovered by `axm-mcp` for AI agent workflows
- ⚡ **Fast & Typed** — Direct httpx calls, strict mypy, 166 tests

---

<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>
