Troubleshooting

Authentication errors

• 401 / Unauthorized: your API key is missing, invalid, or not being picked up.
  • Make sure FASTFOLD_API_KEY is set in your shell/session.
  • If you’re running in a notebook, restart the kernel after setting env vars.
  • Try passing the key explicitly to confirm it works:

from fastfold import Client
client = Client(api_key="sk-...your-api-key")

429 / quota exceeded

All API requests are subject to quota limits. Check the Usage dashboard.

Timeouts while waiting for completion

If your script hits the timeout, increase it and/or reduce polling load:

results = client.jobs.wait_for_completion(
    myJob.id,
    poll_interval=10.0,
    timeout=3600.0,
)

Job status is FAILED or STOPPED

• FAILED: the job encountered an error (invalid input, model constraints, or server error).
• STOPPED: the job was stopped before completion.

Recommended pattern in pipelines:

results = client.jobs.wait_for_completion(myJob.id, poll_interval=5.0, timeout=900.0)
if results.job.status != "COMPLETED":
    raise RuntimeError(f"Job did not complete: status={results.job.status} job_id={myJob.id}")

Artifact URLs are missing

Artifacts can differ between:

• Complex jobs: shared artifacts are available at the top level (e.g. results.cif_url()).
• Non-complex jobs: artifacts are per-sequence; use indexing (e.g. results[0].cif_url()).

See: /docs/developer/python-examples