ncbi-genome-download
Guide safe, reproducible NCBI genome retrieval with ncbi-genome-download, including CLI/API filtering, dry runs, output integrity, metadata, and optional taxonomy expansion.
- License 许可
- Apache-2.0
- 最近更新
- 2026-10-08
- Stars
- ★ 11
- Forks
- 3
01 前言 Front Matter
- name
- ncbi-genome-download
- license
- Apache 2.0
- metadata
- { "disco-role": "operating" }
- description
- Guide safe, reproducible NCBI genome retrieval with ncbi-genome-download, including CLI/API filtering, dry runs, output integrity, metadata, and optional taxonomy expansion.
- disable-model-invocation
- true
02 资源文件 3
- 参考文档references/repo-provenance.md1.6 KB
- 参考文档references/repo-routing-metadata.json354 B
- 参考文档references/troubleshooting.md3.8 KB
03 SKILL.md 正文
ncbi-genome-download
Use this repo skill when a task needs to select, preview, retrieve, or organize
NCBI RefSeq/GenBank assembly files, or when a Python workflow needs the
ncbi-genome-download API. It targets package version 0.3.4 behavior and
keeps network and filesystem side effects explicit.
Route the request
- Choose assemblies, filters, CLI flags, or Python calls: read download-and-filter.
- Choose output layout, checksum/re-run behavior, metadata TSV, parallelism, cache, or symlinks: read output-and-integrity, usually after selecting candidates.
- Expand a taxon name/parent TaxID into a file of descendant TaxIDs: read taxonomy-helper. It is optional and may download or update a local taxonomy database.
- Check installation or package drift: run the bundled
scripts/check_install.py, then read troubleshooting.
For a normal retrieval, first define section, groups, filters, formats, and
an output directory; run a dry run; inspect the candidate count; then remove
--dry-run only after network, disk, and output side effects are approved.
Use comma-separated option values without spaces after commas. A positional
group is required by the CLI even though the help text mentions an all
default.
Install and smoke-check
The public distribution is ncbi-genome-download and provides both
ncbi-genome-download and ngd entry points:
python -m pip install ncbi-genome-download
python -c "import ncbi_genome_download as ngd; print(ngd.__version__)"
ncbi-genome-download --help
The base runtime uses appdirs, requests, and tqdm. The optional taxonomy
helper additionally needs ETE3 and its documented runtime dependencies; do not
install it unless that route is needed. For a source checkout, the package's
focused tests use the testing extra, but native tests are verification
artifacts rather than runtime dependencies of this skill.
Cross-cutting operating rules
- Prefer
--dry-runto validate filters. It still retrieves assembly summary data, but it does not fetch checksum manifests or genome files. - Treat filters as an intersection. Status
1with “No downloads matched your filter” means inspect section, group, exact names, list files, and filter combinations before broadening the request. - Treat status
75as a temporary NCBI connection/chunked-transfer failure; use bounded--retriesand inspect partial output. Status0does not by itself prove every worker's checksum succeeded. - Never treat a TaxID file, metadata table, or human-readable link tree as self-validating. Inspect headers, IDs, target paths, and checksums before downstream analysis.
- Keep the original source checkout out of future runtime instructions. The bundled references and taxonomy helper are the portable replacements.
Read repo provenance before deciding whether this skill matches a changed checkout or whether a refresh is needed. Read cross-cutting troubleshooting for install, network, cache, output, and optional-dependency symptoms that span routes.
04 同仓库更多 Skills
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
python-api
Programmatic Object-Detection-Metrics API guidance for BoundingBox, BoundingBoxes, Evaluator, enums, coordinate conversion, AP/mAP semantics, and source-style import diagnostics.
file-evaluation
Folder-based PASCAL VOC AP/mAP evaluation from ground-truth and detection text files.
object-detection-metrics
Guides legacy Object-Detection-Metrics PASCAL VOC AP/mAP evaluation from detection text folders and direct Python API classes.
nx-workspace-patterns
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.