---
description: "Reports each on-device provider's availability right now."
---

# `detectLocalProviders`

Reports each on-device provider's availability right now. Reach for it to build a settings screen ("this browser can run X"); `createLocalAdapter` uses it to pick a provider.

## Import

```ts
import { detectLocalProviders } from "@webmcp-agents/local-agent";
```

## Example

```ts title="detect.ts"
import { detectLocalProviders } from "@webmcp-agents/local-agent";

// What could run here, for a settings screen. Nothing downloads.
const found = await detectLocalProviders();

for (const { id, availability } of found) {
  console.log(id, availability.state);
}
// prompt-api unavailable
// transformers needs-download
```

## Options

`detectLocalProviders(providers?)` takes one argument.

| Name | Type | Default | Description |
|---|---|---|---|
| `providers` | `readonly LocalProvider[]` | `[createPromptApiProvider(), createTransformersProvider()]` | The providers to check, in order. Pass the instances your adapter uses to see what it sees. |

## Returns

A promise of one entry per provider, in the same order: `{ id: string; availability: ProviderAvailability }`. A provider whose `availability()` rejects is reported as `{ state: "unavailable", reason: String(error) }`.

See [`ProviderAvailability`](/docs/reference/local-agent/provider-types#provideravailability) for the four states.

## Notes

- Checking never downloads anything. The transformers provider may request a WebGPU adapter and ask its worker whether the model is in the browser cache.
- The default list creates fresh providers on each call; pass your own to check the instances your adapter uses.

## See also

- [On-device agent](/docs/more/on-device-agent)
- [`createLocalAdapter`](/docs/reference/local-agent/create-local-adapter)
- [Provider types](/docs/reference/local-agent/provider-types)