---
title: Introduction | Boltz API Docs
description: Run molecular modeling jobs with the Boltz API.
---

The Boltz API lets you run structure prediction, molecular design, and library screening from code.

## Who these docs are for

Each guide shows examples for the audience that matches how you work:

- **Scientist** — you want to run jobs from your own machine, have results land in a local directory, and resume long-running work after a restart. Use the Python `Boltz` client’s higher-level `run_*` / `start_*` methods, or the `boltz-api` CLI with a YAML input file.
- **Platform Developer** — you’re integrating Boltz into a service or app and need direct control over the request/response lifecycle. Use the Python or Typescript SDK to start jobs, poll status, and read download URLs yourself.
- **Agent** — you want Claude Code, Codex, Cursor, or another coding agent to run Boltz jobs for you. Use the CLI-backed agent plugins/skills when available, or give the agent the permission-friendly `boltz-api` command pattern.

Both Python options ship in the same `boltz-api` package on the same `Boltz` client — the difference is which methods you call. `client.experiments.run_*` and `client.experiments.start_*` are the Scientist helpers that wait, download, and organize outputs on disk for you. `client.predictions.*`, `client.protein.*`, and `client.small_molecule.*` are the lower-level Platform Developer methods that return immediately so you can drive polling and downloads from your own service. Agent workflows use the same `boltz-api` CLI underneath, with explicit cost checks, idempotency keys, and resumable downloads.

## Start with a job

- **Predict structure and binding** — Submit a molecular complex and get predicted structures back.\
  [Predict structure and binding →](/docs/guides/predictions/index.md)
- **Design novel molecules** — Generate new small molecules or protein binders with streaming results and optional early stopping.\
  [Small molecule design →](/docs/guides/small-molecule-design/index.md) · [Protein design →](/docs/guides/protein-design/index.md)
- **Screen a library** — Score your own small molecules or protein sequences against a target.\
  [Small molecule screen →](/docs/guides/small-molecule-library-screen/index.md) · [Protein screen →](/docs/guides/protein-library-screen/index.md)

## Next steps

- [Get started](/docs/guides/getting-started/index.md) — Create an account, install a client, and run the smallest complete example
- [Authentication](/docs/guides/authentication/index.md) — API key types and SDK setup
- [Agent integrations](/docs/guides/agent-integrations/index.md) — Use Boltz from Claude Code, Codex, and other coding agents
- [API Reference](/docs/api/index.md) — Full endpoint documentation with SDK examples