> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2.mintlify.site/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/).

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

```bash Windows theme={null}
setx XAI_API_KEY xai-***
```

## Example

Use `xAI` with your `Agent`:

```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.")
```

## Live Search

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

```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?")
```

> [!NOTE]
>
> View more examples [here](https://agno-v2.mintlify.site/models/providers/native/xai/usage/basic.md).

## 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](https://agno-v2.mintlify.site/reference/models/openai.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.