# zidane/providers/cerebras

> The Cerebras provider for open models hosted on Cerebras.

Import: `import { … } from 'zidane/providers/cerebras'`. Source: [src/providers/cerebras.ts](https://github.com/Tahul/zidane/blob/main/src/providers/cerebras.ts).

Use `cerebras()` when your agent runs on Cerebras. It reads `CEREBRAS_API_KEY` when you pass no key. It wraps `openaiCompat()`, so it uses the OpenAI-compatible API. See [Providers](https://zidane.si/docs/providers.md).

```ts
import { createAgent } from 'zidane'
import { cerebras } from 'zidane/providers/cerebras'

const agent = createAgent({ provider: cerebras({ defaultModel: 'gpt-oss-120b' }) })
const stats = await agent.run({ prompt: 'Summarize README.md in three bullets.' })
console.log(stats.turns)
```

## Functions

### `cerebras`

Function.

Cerebras provider.

Thin wrapper around [`openaiCompat`](https://zidane.si/docs/reference/providers-openai-compat.md#openaiCompat) with Cerebras-specific defaults
(base URL, default model).

```ts
function cerebras(params?: CerebrasParams): Provider
```

**Parameters**

- `params?` (`CerebrasParams`): API key, default model, capabilities and extra headers.

**Returns** `Provider`

**Example**

```ts
import { createAgent } from 'zidane'
import { cerebras } from 'zidane/providers/cerebras'

const agent = createAgent({
  provider: cerebras({ apiKey: process.env.CEREBRAS_API_KEY }),
})
await agent.run({ prompt: 'Say hello.' })
```

Source: [src/providers/cerebras.ts:61](https://github.com/Tahul/zidane/blob/main/src/providers/cerebras.ts#L61)

## Interfaces

### `CerebrasParams`

Interface.

Options for [`cerebras`](https://zidane.si/docs/reference/providers-cerebras.md#cerebras).

```ts
interface CerebrasParams
```

**Properties**

- `apiKey?` (`string`): API key. Falls back to the `CEREBRAS_API_KEY` environment variable.
- `capabilities?` (`ProviderCapabilities`): Provider capability flags. Cerebras currently serves text-only OSS models
  (GLM, Llama-family, Qwen-family) — default: `{ vision: false, imageInToolResult: false }`.
  Override when routing to a vision-capable deployment.
- `defaultModel?` (`string`, default `'gpt-oss-120b'`): Model used when a request does not set one.
- `extraHeaders?` (`Record<string, string>`): Extra HTTP headers sent on every request. Forwarded to the underlying
  [`openaiCompat`](https://zidane.si/docs/reference/providers-openai-compat.md#openaiCompat) client — use for routing/attribution headers a proxy
  in front of `baseURL` consumes.

Source: [src/providers/cerebras.ts:7](https://github.com/Tahul/zidane/blob/main/src/providers/cerebras.ts#L7)