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

# xAI Provider

> Use xAI Grok models with PraisonAI TypeScript

```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
graph LR
    U[Input] --> A[Agent]
    A --> O[Output]

    classDef agent fill:#8B0000,color:#fff
    classDef tool fill:#189AB4,color:#fff

    class A agent
    class U,O tool
```

# xAI Provider

Use xAI's Grok models including Grok-4 and Grok-3.

## Environment Variables

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
export XAI_API_KEY=xai-...
```

## Supported Modalities

| Modality   | Supported |
| ---------- | --------- |
| Text/Chat  | ✅         |
| Embeddings | ❌         |
| Image      | ✅         |
| Tools      | ✅         |

## Quick Start

<Steps>
  <Step title="Simple Usage">
    ```typescript theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    import { Agent } from 'praisonai';

    const agent = new Agent({
      name: 'Grok',
      instructions: 'You are a helpful assistant.',
      llm: 'xai/grok-3'
    });

    const response = await agent.chat('Hello!');
    console.log(response);
    ```
  </Step>

  <Step title="With Configuration">
    Adjust provider credentials and model settings for production — see the sections above.
  </Step>
</Steps>

## Available Models

| Model         | Description       |
| ------------- | ----------------- |
| `grok-4`      | Latest Grok model |
| `grok-3`      | Grok 3            |
| `grok-3-fast` | Fast variant      |
| `grok-3-mini` | Lightweight       |

## Troubleshooting

### Missing API Key

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
export XAI_API_KEY=xai-your-key
```

## Related

<CardGroup cols={2}>
  <Card title="xAI CLI Usage" icon="terminal" href="/docs/js/providers/xai-cli">
    xAI CLI Usage
  </Card>

  <Card title="Providers Overview" icon="book" href="/docs/js/providers">
    Providers Overview
  </Card>
</CardGroup>