protein-folding-api / README.md
edbeeching's picture
edbeeching HF Staff
Add ESMFold folding API
8ab4ff2 verified
---
title: Carbon Protein Folding API
emoji: 🧬
colorFrom: green
colorTo: blue
sdk: docker
app_port: 7860
fullWidth: true
tags:
- biology
- protein-folding
- esmfold
- fastapi
- carbon
---
# Carbon Protein Folding API
FastAPI service for the Carbon DNA-to-Structure demo. The first live backend is ESMFold for single-chain protein folding.
## Endpoints
- `GET /health`
- `GET /tools`
- `POST /jobs`
- `GET /jobs/{job_id}`
`POST /jobs` accepts one protein entity and returns immediately with a `job_id`. Poll `GET /jobs/{job_id}` until the job reaches `succeeded` or `failed`.
## Configuration
Set these Space variables/secrets:
```sh
FOLD_BACKEND=esmfold
FOLD_API_TOKEN=...
MAX_PROTEIN_AA=400
```
For local CPU tests, use:
```sh
FOLD_BACKEND=stub uvicorn folding_api_service.app:app --host 0.0.0.0 --port 7860
```