# providerkit

> One seam for every LLM provider, plus the failure handling you only learn in production. Zero dependencies, fetch-only, MIT.

- Install: `bun add @providerkit/core` (npm/pnpm/yarn also fine). ESM only.
- It is NOT an agent framework: no loop, no prompts, no memory, no graph.
- Zero runtime dependencies, `fetch` only, so one build runs in Bun, Node,
  Cloudflare Workers, Deno and a Chrome MV3 service worker.
- Errors are classified into 13 kinds named by what FIXES them, not by vendor
  or HTTP status. See the Errors guide before reasoning about a failure.
- All 13 kinds with their remedy, `isTransient` and `isBackupEligible` flags
  are available as data at https://providerkit.dev/kinds.json
- Every page also serves its own markdown: append `.md` to any path, e.g.
  https://providerkit.dev/guides/errors.md

## Documentation Sets

- [Abridged documentation](https://providerkit.dev/llms-small.txt): a compact version of the documentation for providerkit, with non-essential content removed
- [Complete documentation](https://providerkit.dev/llms-full.txt): the full documentation for providerkit
- [Guides](https://providerkit.dev/_llms-txt/guides.txt): the hand-written guides only: setup, errors, retries, streaming, sign-in, tools, context, resume, cost, decision models
- [API reference](https://providerkit.dev/_llms-txt/api-reference.txt): every exported symbol, generated from the TypeScript source

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation

## Optional

- [npm](https://www.npmjs.com/package/@providerkit/core)
- [Source](https://github.com/providerkit/providerkit)
- [Error kinds as JSON](https://providerkit.dev/kinds.json)