README.md

metadata

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:

FOLD_BACKEND=esmfold
FOLD_API_TOKEN=...
MAX_PROTEIN_AA=400

For local CPU tests, use:

FOLD_BACKEND=stub uvicorn folding_api_service.app:app --host 0.0.0.0 --port 7860