cli-inference
Run, script, and troubleshoot Chai-1 folding with the chai-lab fold CLI and chai_lab.chai1.run_inference API.
- License 许可
- Apache-2.0
- 最近更新
- 2026-10-08
- Stars
- ★ 11
- Forks
- 3
01 前言 Front Matter
- name
- cli-inference
- license
- Apache 2.0
- metadata
- { "disco-role": "operating" }
- description
- Run, script, and troubleshoot Chai-1 folding with the chai-lab fold CLI and chai_lab.chai1.run_inference API.
- disable-model-invocation
- true
02 资源文件 3
- 参考文档references/api-reference.md8.1 KB
- 参考文档references/inference-workflows.md6.0 KB
- 参考文档references/troubleshooting.md5.7 KB
03 SKILL.md 正文
Chai-1 CLI and Inference
Use this sub-skill when the task is to run, template, script, or debug Chai-1 molecular structure prediction through chai-lab fold or chai_lab.chai1.run_inference.
Use This For
- Constructing
chai-lab foldcommands, including device, seed, recycle, sample, and output settings. - Writing Python inference scripts around
chai_lab.chai1.run_inferenceand readingStructureCandidatesoutputs. - Diagnosing inference setup failures: non-empty output directories, CUDA/device problems, model downloads, and long-running jobs.
- Routing advanced custom-context work to
make_all_atom_feature_contextplusrun_folding_on_context.
Route Elsewhere
- FASTA entity syntax, duplicate entity names, ligands, DNA/RNA, and chain-name choices:
../input-data-formats/SKILL.md. - MSA
.aligned.pqt, ColabFold server,a3m-to-pqt, and template hit files:../msa-templates/SKILL.md. - Contact, pocket, covalent, and glycan restraints:
../restraints-glycans/SKILL.md.
Quick Start
Install a pinned public package build or a Git build in a Linux Python 3.10+ environment:
pip install chai_lab==0.6.1
# or: pip install git+https://github.com/chaidiscovery/chai-lab.git
Run a minimal ESM-only fold, writing to a new or empty directory:
chai-lab fold input.fasta outputs/chai-run --seed 42 --device cuda:0
Print citation metadata without running inference:
chai-lab citation
Generate a configurable Python script template without starting a GPU job:
python scripts/write_inference_template.py \
--fasta input.fasta \
--output-dir outputs/chai-run \
--script-out run_chai_inference.py \
--device cuda:0 \
--seed 42
Runtime Expectations
- Chai-1 inference is intended for Linux, Python
>=3.10, and a CUDA GPU with bfloat16 support; do not promise practical CPU inference. - The default device is effectively
cuda:0ifdeviceis not provided. - Model and helper assets download automatically on first use. Set
CHAI_DOWNLOADS_DIR=/path/to/cachewhen the default package-local download location is unsuitable. - Folding can be slow and memory-intensive. Reduce
--num-diffn-samples,--num-diffn-timesteps, or input size for faster/cheaper exploratory runs. output_dirmust not contain existing files; create a fresh run directory or deliberately clean it before invoking inference.
Reference Map
references/inference-workflows.md: command recipes, output handling, and script templates.references/api-reference.md: exact Python APIs, parameters, outputs, and advanced context route.references/troubleshooting.md: common failures and safe diagnosis steps.scripts/write_inference_template.py: bundled helper that writes a configurable Python inference template.
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.