Fastfold CLI — An autonomous agent for drug discovery research
Project description
Fastfold Agent CLI
Where scientists and AI agents work together doing real science.
Ask questions in natural language. Fastfold CLI plans the analysis, selects the right tools, executes them, validates results, and returns data-backed conclusions. Integrates with Fastfold AI Cloud for GPU compute, protein folding, workflow orchestration, and team collaboration.
Built on top of Claude Agent SDK and CellType CLI.
Quick install
Requires Python 3.10+.
uv tool install "fastfold-agent-cli[all]" --python 3.10
Authentication
# Interactive setup wizard (recommended — configures Anthropic + Fastfold AI Cloud keys)
fastfold setup
# Or set directly
export ANTHROPIC_API_KEY="sk-ant-..."
export FASTFOLD_API_KEY="sk-..."
# Non-interactive (CI/scripting)
fastfold setup --api-key sk-ant-... --fastfold-api-key sk-...
Getting Started
# Start interactive session
fastfold
# Single query
fastfold "What are the top degradation targets for this compound?"
# Validate setup
fastfold doctor
# List available tools
fastfold tool list
# List loaded skills
fastfold skill list
Interactive commands
Inside fastfold interactive mode:
/help— command reference + examples/tools— list all tools with status/agents N <query>— run N parallel research agents/sessions,/resume— session lifecycle/copy,/export— save/share outputs/usage— token and cost tracking
Quick examples
Target prioritization
fastfold "I have a CRBN molecular glue. Proteomics shows it degrades
IKZF1, GSPT1, and CK1α. Which target should I prioritize?"
Protein folding
fastfold "Fold this sequence with boltz-2 and find the binding pockets: MALWMRLLPLL..."
Combination strategy
fastfold "My lead compound is immune-cold. What combination strategy should I use?"
Key Features
190+ Domain Tools
| Category | Examples |
|---|---|
| Target | Neosubstrate scoring, degron prediction, co-essentiality networks |
| Chemistry | SAR analysis, fingerprint similarity, scaffold clustering |
| Expression | L1000 signatures, pathway enrichment, TF activity, immune scoring |
| Viability | Dose-response modeling, PRISM screening, therapeutic windows |
| Biomarker | Mutation sensitivity, resistance profiling, dependency validation |
| Clinical | Indication mapping, population sizing, TCGA stratification |
| Safety | Anti-target flagging, multi-modal profiling, SALL4 risk |
| Structure | AlphaFold fetch, docking, binding sites, MD simulation |
| Folding | Fastfold AI Cloud: boltz-2, monomer, multimer, simplefold_* |
| Literature | PubMed, OpenAlex, ChEMBL search |
| DNA | ORF finding, codon optimization, primer design, Gibson/Golden Gate assembly |
Agent Skills
Fastfold CLI ships with a bundled skill catalog and supports user-installed skills:
fastfold skill list # see loaded skills
# Install additional skills (requires npx), check https://skills.sh
npx skills addd <owner/repo>
Data Management
fastfold data pull depmap # DepMap CRISPR, mutations, expression
fastfold data pull prism # PRISM cell viability
fastfold data pull msigdb # Gene sets
# Or point to existing data
fastfold config set data.depmap /path/to/depmap/
Reports
fastfold report list # list reports
fastfold report publish # convert latest .md to .html
fastfold report show # open in browser
Troubleshooting
| Symptom | Fix |
|---|---|
fastfold fails at startup |
fastfold doctor |
| No API key | fastfold setup or export ANTHROPIC_API_KEY=... |
| Data not found | fastfold data pull <dataset> |
| Missing dependency | pip install "fastfold-agent-cli[all]" |
| Session lost | fastfold --continue |
Contributing
git clone https://github.com/fastfold-ai/fastfold-agent-cli.git
cd fastfold-agent-cli
uv venv --python 3.12 && uv sync
fastfold setup
pytest tests/
License
MIT — see LICENSE
Credits
Based on CellType CLI
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file fastfold_agent_cli-0.0.8.tar.gz.
File metadata
- Download URL: fastfold_agent_cli-0.0.8.tar.gz
- Upload date:
- Size: 932.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fc83e484a733fdbc3bba90311e6b6e21dd1d3dedb80f4b91c8f55fe497049556
|
|
| MD5 |
b0fdb87543f4afbd791e64e4d23a65c6
|
|
| BLAKE2b-256 |
d7889e52cb67c1435e0c1db0d14591dd7d277e550ba49f96e4227b9a390278c3
|
Provenance
The following attestation bundles were made for fastfold_agent_cli-0.0.8.tar.gz:
Publisher:
publish.yml on fastfold-ai/fastfold-agent-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
fastfold_agent_cli-0.0.8.tar.gz -
Subject digest:
fc83e484a733fdbc3bba90311e6b6e21dd1d3dedb80f4b91c8f55fe497049556 - Sigstore transparency entry: 992922472
- Sigstore integration time:
-
Permalink:
fastfold-ai/fastfold-agent-cli@593891ee5c2e3bbc47b79e83ba3508a9b4aab34c -
Branch / Tag:
refs/tags/v0.0.8 - Owner: https://github.com/fastfold-ai
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@593891ee5c2e3bbc47b79e83ba3508a9b4aab34c -
Trigger Event:
push
-
Statement type:
File details
Details for the file fastfold_agent_cli-0.0.8-py3-none-any.whl.
File metadata
- Download URL: fastfold_agent_cli-0.0.8-py3-none-any.whl
- Upload date:
- Size: 470.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fcd225d45532f081e4cf843934f314917552b7e916442ed8973a403aee2d00b7
|
|
| MD5 |
0673c2bb8907b828afa88728fc68ca5d
|
|
| BLAKE2b-256 |
b63f0dee6f4e1944438876ad1dee275024671ce387972f20c106028a8a0eb867
|
Provenance
The following attestation bundles were made for fastfold_agent_cli-0.0.8-py3-none-any.whl:
Publisher:
publish.yml on fastfold-ai/fastfold-agent-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
fastfold_agent_cli-0.0.8-py3-none-any.whl -
Subject digest:
fcd225d45532f081e4cf843934f314917552b7e916442ed8973a403aee2d00b7 - Sigstore transparency entry: 992922541
- Sigstore integration time:
-
Permalink:
fastfold-ai/fastfold-agent-cli@593891ee5c2e3bbc47b79e83ba3508a9b4aab34c -
Branch / Tag:
refs/tags/v0.0.8 - Owner: https://github.com/fastfold-ai
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@593891ee5c2e3bbc47b79e83ba3508a9b4aab34c -
Trigger Event:
push
-
Statement type: