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

# AI Model Configuration

> Choose between Rancher Oracle and BYO model for AI-powered diagnostics.

Pastures supports two AI model options for diagnostics: the hosted **Rancher Oracle** service and **BYO (Bring Your Own)** model via any OpenAI-compatible endpoint.

## Comparison

| Feature                  | Rancher Oracle                   | BYO Model               |
| ------------------------ | -------------------------------- | ----------------------- |
| AI diagnostics           | ✓                                | ✓                       |
| Grounded in real fixes   | ✓ (48K+ issues from 13 repos)    | —                       |
| Source citations         | ✓ GitHub issue links             | —                       |
| Fleet correlation        | ✓ Cross-cluster pattern matching | —                       |
| Fix verification         | ✓ Post-fix monitoring            | —                       |
| Custom model choice      | —                                | ✓ Any model             |
| Local/air-gapped support | —                                | ✓ (via Ollama)          |
| Cost                     | \$200/mo per cluster             | Your provider's pricing |

## Rancher Oracle

Oracle is a hosted RAG (Retrieval-Augmented Generation) service that searches a curated corpus of 48,000+ real issue resolutions from K3s, Rancher, RKE2, Longhorn, Harvester, and other SUSE/Rancher projects. Diagnostics include direct links to the GitHub issues that informed the fix.

<Card title="Set up Oracle" icon="key" href="/configuration/oracle-setup">
  Get an API key and connect to Oracle
</Card>

## BYO Model

Point Pastures at any OpenAI-compatible API endpoint. Supported providers include OpenAI, Anthropic, Ollama, Azure OpenAI, and any custom endpoint that implements the OpenAI chat completions API.

<Card title="Set up BYO model" icon="plug" href="/configuration/byo-model">
  Configure your own model endpoint
</Card>

<Info>
  BYO mode provides AI diagnostics using your chosen model's general knowledge. It does not include source citations from the Rancher ecosystem or cross-cluster fleet correlation — those features require the Oracle corpus.
</Info>

## Demo mode

Not ready to configure a model? Enable [demo mode](/configuration/demo-mode) to explore AI diagnostics with synthetic responses, including mock source citations.