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

# xAI

> Use xAI Grok models with Agno agents.

xAI provides the Grok family of large language models.
See their list of models [here](https://docs.x.ai/docs/models).

We recommend experimenting to find the best-suited model for your use-case. The default `grok-4-1-fast-non-reasoning-latest` model is good for most use-cases.

## Installation

```bash theme={null}
uv pip install openai agno
```

## Authentication

Set your `XAI_API_KEY` environment variable. You can get one [from xAI here](https://console.x.ai/).

<CodeGroup>
  ```bash Mac theme={null}
  export XAI_API_KEY=xai-***
  ```

  ```bash Windows theme={null}
  setx XAI_API_KEY xai-***
  ```
</CodeGroup>

## Example

Use `xAI` with your `Agent`:

<CodeGroup>
  ```python agent.py theme={null}
  from agno.agent import Agent
  from agno.models.xai import xAI

  agent = Agent(
      model=xAI(id="grok-4-1-fast-non-reasoning-latest"),
      markdown=True
  )

  agent.print_response("Share a 2 sentence horror story.")
  ```
</CodeGroup>

## Live Search

xAI models support live search capabilities that can access real-time information:

<CodeGroup>
  ```python live_search.py theme={null}
  from agno.agent import Agent
  from agno.models.xai import xAI

  agent = Agent(
      model=xAI(
          id="grok-4-1-fast-non-reasoning-latest",
          search_parameters={
              "mode": "on",
              "max_search_results": 20,
              "return_citations": True,
          },
      ),
      markdown=True,
  )

  agent.print_response("What's the latest news about AI developments?")
  ```
</CodeGroup>

<Note> View more examples [here](/models/providers/native/xai/usage/basic). </Note>

## Parameters

| Parameter           | Type                       | Default                                | Description                                             |
| ------------------- | -------------------------- | -------------------------------------- | ------------------------------------------------------- |
| `id`                | `str`                      | `"grok-4-1-fast-non-reasoning-latest"` | The id of the xAI model to use                          |
| `name`              | `str`                      | `"xAI"`                                | The name of the model                                   |
| `provider`          | `str`                      | `"xAI"`                                | The provider of the model                               |
| `api_key`           | `Optional[str]`            | `None`                                 | The API key for xAI (defaults to `XAI_API_KEY` env var) |
| `base_url`          | `str`                      | `"https://api.x.ai/v1"`                | The base URL for the xAI API                            |
| `search_parameters` | `Optional[Dict[str, Any]]` | `None`                                 | Search parameters for enabling live search              |

`xAI` also supports the params of [OpenAI](/reference/models/openai).