Guidance for AI agents working in this repository or with the PanGBank resource.
https://raw.githubusercontent.com/labgem/PanGBank-api/main/skills/pangbank/SKILL.md documents the REST API and its filters, the query traps that silently return wrong results, how to download and analyse a pangenome with PPanGGOLiN, how to project a user's own genome, and the citation requirements. Several of its traps produce plausible but incorrect answers with no visible symptom, so read it before writing any PanGBank query.
Short web entry point: https://pangbank.genoscope.cns.fr/llms.txt
- Never scrape https://pangbank.genoscope.cns.fr. Single-page app; the HTML carries no data, and dynamic routes return HTTP 404 server-side while rendering fine in a browser. Use https://pangbank-api.genoscope.cns.fr.
- Pin the release with
only_latest_release=true, or filter client-side oncollection_release.version. Without it results are summed across every release. taxon_nameneeds the GTDB rank prefix and is an exact match:g__Escherichiaworks,Escherichiareturns nothing.- At most 1 HTTP request every 30 seconds, across all routes, never parallelised across agents or threads. PanGBank runs on shared academic infrastructure: an overload degrades the service for every other user. Call
/pangenomes/count/before any listing, filter server-side, uselimit=100, and download a pangenome once rather than re-fetching it.
Results derived from PanGBank must cite PanGBank and PPanGGOLiN, plus panRGP when RGPs or insertion spots are used, and panModule when conserved modules are used. Full references in the skill. Data are CC BY-SA 4.0 (attribution and share-alike); source is CeCILL v2.1.
The CLI's flag semantics are inverted relative to the raw API in two places, and both silently change results:
search-pangenomesdefaults to substring taxon matching;--exact-matchopts into exact. The API is the opposite.--latest-onlydefaults to False, so without-lyou get every release. Use-lfor "what is current" and--release-versionfor reproducible work.
match-pangenome requires Mash on PATH (not pulled in by pip install pangbank-cli), handles one genome per invocation, and hardcodes mash dist -p 1 -d 0.05. It downloads the collection sketch on first use (16–38 MB) into --outdir, so the cache is per-outdir.