README.md

---
title: AlphaFold Adaptive API
emoji: 🧬
colorFrom: blue
colorTo: purple
sdk: docker
app_port: 7860
pinned: false
---

# AlphaFold Adaptive API

Adaptive protein intelligence backend for the [AlphaFold custom GPT](https://chatgpt.com/g/g-676aa662c16c81919391f7b0b9f76ee1-alphafold).

## Features

- **Adaptive context engine** — tracks session history, infers user expertise, and generates dynamic system prompt extensions
- **Morphic simulations** — Gray-Scott reaction-diffusion patterns self-assembled from protein pLDDT, chain length, and functional class
- **ESM-2 embeddings** — `facebook/esm2_t6_8M_UR50D` protein language model for sequence embeddings
- **Live AlphaFold DB + UniProt** — real-time structure and metadata fetch
- **Per-residue pLDDT heatmap** — confidence visualization
- **OpenAPI 3.1 schema** — wired as a GPT Action

## Endpoints

| Method | Path | Description |
|--------|------|-------------|
| POST | `/analyze` | Full analysis + adaptive context |
| GET | `/structure/{id}` | Structure summary |
| POST | `/simulate` | Morphic PNG (base64) |
| GET | `/simulate/image/{id}` | Morphic PNG direct |
| GET | `/simulate/heatmap/{id}` | pLDDT heatmap PNG |
| POST | `/context` | Adaptive session context |
| GET | `/docs` | Swagger UI |
| GET | `/openapi.json` | OpenAPI schema |