Skip to main content

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
fastfold data pull alphafold     # Protein structures (on-demand)

# 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fastfold_agent_cli-0.0.21.tar.gz (967.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fastfold_agent_cli-0.0.21-py3-none-any.whl (518.9 kB view details)

Uploaded Python 3

File details

Details for the file fastfold_agent_cli-0.0.21.tar.gz.

File metadata

  • Download URL: fastfold_agent_cli-0.0.21.tar.gz
  • Upload date:
  • Size: 967.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for fastfold_agent_cli-0.0.21.tar.gz
Algorithm Hash digest
SHA256 341ff7a225865f0c0f8a2131c3d47fe5eca0b12695b63ceabcb08094aeeb35a5
MD5 31ae19cb919daf00cb8fee224206c1be
BLAKE2b-256 5c9ff16abbfa30455ac22c003df44e7781387828888e4f64a00d237ed682b02d

See more details on using hashes here.

Provenance

The following attestation bundles were made for fastfold_agent_cli-0.0.21.tar.gz:

Publisher: publish.yml on fastfold-ai/fastfold-agent-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file fastfold_agent_cli-0.0.21-py3-none-any.whl.

File metadata

File hashes

Hashes for fastfold_agent_cli-0.0.21-py3-none-any.whl
Algorithm Hash digest
SHA256 5c2c3899241069b0dcdff66956b8cd715b39fe0b4be5e12186808417e3d9b3d9
MD5 b487e6fbab6acaac65d9f9ea7da3326b
BLAKE2b-256 dda755a002f7d4bcf6d3b1d7c0db5223476996f1f3895430be9e837ea2564863

See more details on using hashes here.

Provenance

The following attestation bundles were made for fastfold_agent_cli-0.0.21-py3-none-any.whl:

Publisher: publish.yml on fastfold-ai/fastfold-agent-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page