setup
First-time setup for protein design tools. Use this skill when: (1) User is new and hasn't run any tools yet, (2) Commands fail with "file not found" or "modal: command not found", (3) Modal authentication errors occur, (4) User asks how to get started or set up the environment, (5) biomodals directory is missing or tools aren't working.
npx skills add BioTender-max/awesome-bio-agent-skills --skill setup --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Setup Guide Help users get their environment ready to run protein design tools. ## Quick checklist Run through this checklist when a user encounters setup issues: | Step | Check | Fix | |------|-------|-----| | 1. Modal CLI | `modal --version` | `pip install modal` | | 2. Modal auth | `modal token show` | `modal setup` | | 3. biomodals | `ls biomodals/modal_*.py` | `git clone https://github.com/hgbrian/biomodals` | | 4. Test | `cd biomodals && modal run modal_boltzgen.py --help` | See troubleshooting | ## Diagnosing issues ### Error: "modal: command not found" **Cause**: Modal CLI not installed. **Fix**: ```bash pip install modal ``` Then restart the terminal or run `hash -r`. ### Error: "Permission denied" or "Unauthorized" **Cause**: Modal not authenticated. **Fix**: ```bash modal setup ``` This opens a browser. Click "Authorize" to complete authentication. ### Error: "No such file or directory: modal_boltzgen.py" **Cause**: biomodals repository not cloned or not in correct directory. **Fix**: ```bash git clone https://github.com/hgbrian/biomodals cd biomodals ``` ### Error: "uvx: command not found" **Cause**: `uvx` is an optional wrapper from the `uv` package. It's not require
- Quick checklist
- Diagnosing issues
- Error: "modal: command not found"
- Error: "Permission denied" or "Unauthorized"
- Error: "No such file or directory: modalboltzgen.py"
- Error: "uvx: command not found"
- Full setup steps
- Step 1: Install Modal CLI
- Step 2: Authenticate Modal
- Step 3: Clone biomodals
- Step 4: Test the Setup
- Common workflows after setup
- GPU selection
- Modal free tier
pip install modal modal setup git clone https://github.com/hgbrian/biomodals cd biomodals modal run modal_boltzgen.py --help pip install uv Design binders with BoltzGen (requires YAML config) modal run modal_boltzgen.py --input-yaml binder.yaml --protocol protein-anything --num-designs 50 Generate backbones with RFdiffusion modal run modal_rfdiffusion.py --pdb target.pdb --contigs "A1-150/0 70-100" --num-designs 100
What does the setup skill do?
First-time setup for protein design tools. Use this skill when: (1) User is new and hasn't run any tools yet, (2) Commands fail with "file not found" or "modal: command not found", (3) Modal authentication errors occur, (4) User asks how to get started or set up the environment, (5) biomodals directory is missing or tools aren't working.
How do I install it?
Run `npx skills add BioTender-max/awesome-bio-agent-skills --skill setup --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From BioTender-max/awesome-bio-agent-skills, a repository with 135 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.