> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kallima.bio/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> What Kallima is and who it's for.

Kallima is an antibody design API. You send it VH/VL sequences; it returns humanized variants, predicted structures, stability analyses, immunogenicity scores, and antibody-antigen complex predictions. Each pipeline runs on GPU in the cloud — you submit a job and poll (or subscribe via webhook) for results.

The API is designed for **bioinformaticians and engineers at small-to-mid-size biotechs** who want to embed antibody optimization into existing Python pipelines, Jupyter notebooks, and LIMS integrations without standing up their own compute infrastructure.

## What you can do

| Endpoint                           | What it runs                                   | Typical turnaround |
| ---------------------------------- | ---------------------------------------------- | ------------------ |
| `GET /v1/me`                       | Credit balance + org identity                  | instant            |
| `POST /v1/humanizations`           | CDR grafting + back-mutation strategies        | \~15–30 s          |
| `POST /v1/structure-predictions`   | ImmuneBuilder ABodyBuilder2 / NanoBodyBuilder2 | \~1–3 min          |
| `POST /v1/stability-analyses`      | ΔΔG, solubility, thermostability               | \~1–3 min          |
| `POST /v1/immunogenicity-analyses` | MHC-I/II + B-cell epitope risk                 | \~1–3 min          |
| `POST /v1/complex-predictions`     | Boltz-2 antibody-antigen docking               | \~20–40 min        |
| `POST /v1/codon-exports`           | Codon-optimized CDS (FASTA / CSV / GenBank)    | \~30–60 s          |

## How the data model works

Everything lives under a **project**. A project holds **source antibodies** (your parental sequences) and **therapeutic candidates** (the design series you're optimizing). Each candidate has one or more **variants** — a baseline variant is created automatically when you register a candidate, and you create new variants as you iterate. Pipelines run against a variant.

```
project
  ├── source_antibodies    (parental sequences)
  └── therapeutic_candidates
        └── variants
              └── jobs     (humanization, structure, stability, immunogenicity, complex)
                    └── results
```

## Base URL

```
https://api.kallima.bio
```

All endpoints require HTTPS.

## Client libraries

<CardGroup cols={2}>
  <Card title="Python SDK" icon="python" href="/quickstart">
    `pip install kallima` — typed wrappers, auto-pagination, built-in polling.
  </Card>

  <Card title="REST API" icon="code" href="/authentication">
    Any HTTP client works — `curl`, `httpx`, `requests`, Postman.
  </Card>
</CardGroup>