paperhound

Research papers,
from your terminal.

Search seven academic sources, download PDFs, and convert them to Markdown.

Install paperhound Add the agent skill
Paperhound, a cheerful long-eared hound in a red neckerchief, proudly fetching an academic paper.
1 / Search paperhound search "attention" -n 5

Install the CLI

Requires Python 3.10 or newer.

uv tool install paperhound
pip install paperhound

Use either command. Optional embedding rerank: pip install 'paperhound[rerank]'.

Add the agent skill

Command reference and research workflows for your coding agent.

npx skills add alexfdez1010/paperhound

Use --json with search, metadata and citation commands when an agent needs to parse the output.

Sources: arXiv, OpenAlex, DBLP, Crossref and Hugging Face Papers by default. Enable Semantic Scholar or CORE with --source; check credentials with paperhound providers.

Commands

All flags and examples ↗
Run with paperhound <command>. Add --help for options.
CommandPurpose
search <query>Search and filter by year, author, venue or publication type.
show <id>Read metadata and abstracts; export BibTeX, RIS or CSL-JSON.
get <id>Download a paper and convert it to Markdown.
download <id>Save the open-access PDF.
convert <pdf>Convert a PDF to Markdown, with optional figures, equations and tables.
refs / cited-by <id>Explore references and papers that cite a work.
add / list / grep / rmSave, browse, search and remove papers in your local library.
providersCheck available sources and their configuration.
mascot --animatePlay the two-second ASCII mascot animation.
Cite paperhound (BibTeX)
@software{paperhound, author = {Fern{\'a}ndez Camello, Alejandro}, title = {paperhound: a fast, agent-ready CLI for academic paper retrieval}, year = {2026}, url = {https://github.com/alexfdez1010/paperhound}, version = {0.5.6}, license = {MIT} }