xAI

Use xAI Grok models with Agno agents.

xAI is a platform for providing endpoints for Large Language models. See their list of models here.

We recommend experimenting to find the best-suited model for your use-case. The grok-3 model is good for most use-cases.

Authentication

Set your XAI_API_KEY environment variable. You can get one from xAI here.

Mac

export XAI_API_KEY=sk-***

setx XAI_API_KEY sk-***

Example

Use xAI with your Agent:

agent.py

from agno.agent import Agent
from agno.models.xai import xAI

agent = Agent(
    model=xAI(id="grok-3"),
    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:

live_search.py

from agno.agent import Agent
from agno.models.xai import xAI

agent = Agent(
    model=xAI(
        id="grok-3",
        search_parameters={
            "mode": "on",
            "max_search_results": 20,
            "return_citations": True,
        },
    ),
    markdown=True,
)

agent.print_response("What's the latest news about AI developments?")

View more examples here.

Params

Parameter	Type	Default	Description
id	str	"grok-beta"	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

xAI also supports the params of OpenAI.