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

# Setting up LM Studio

> Configure LM Studio to run local LLMs with Oryx

## Setup Guide

<Steps>
  <Step title="Open LM Studio">
    Open LM Studio, navigate to the **Developer** page and select the desired model to load.

    <Frame>
      <img src="https://mintcdn.com/lol-87e214d6/eTkn-8G54o6wzba3/images/setting-up-lm-studio/lmstudio-step1.png?fit=max&auto=format&n=eTkn-8G54o6wzba3&q=85&s=0075c39648e01c463b13761475adc96f" alt="Open LM Studio" width="1818" height="1527" data-path="images/setting-up-lm-studio/lmstudio-step1.png" />
    </Frame>
  </Step>

  <Step title="Load the Model">
    In this example, we're loading the `openai/gpt-oss-20b` model.

    <Frame>
      <img src="https://mintcdn.com/lol-87e214d6/eTkn-8G54o6wzba3/images/setting-up-lm-studio/lmstudio-step2.png?fit=max&auto=format&n=eTkn-8G54o6wzba3&q=85&s=f1f1d93c96862b9ca7a8281941392683" alt="Load the model" width="1818" height="1527" data-path="images/setting-up-lm-studio/lmstudio-step2.png" />
    </Frame>
  </Step>

  <Step title="Configure in Oryx">
    * Navigate to `chrome://settings/Oryx` or go to **Settings → Oryx AI**
    * Click **Add Provider**
    * Select **OpenAI Compatible** in the Provider Type dropdown

    <Frame>
      <img src="https://mintcdn.com/lol-87e214d6/HQWW0FFWRvqlfAYo/images/provider-setting.png?fit=max&auto=format&n=HQWW0FFWRvqlfAYo&q=85&s=59b15163df7b8e3fb25079358d3e109b" alt="Configure in Oryx" width="1280" height="827" data-path="images/provider-setting.png" />
    </Frame>
  </Step>

  <Step title="Configure the Model">
    * Replace the Base URL with LM Studio URL (default: `http://localhost:1234/v1/`)
    * Set the Model ID to the one you loaded in LM Studio
    * **Important:** Set the **Context Window Size** to match your LM Studio configuration

    <Frame>
      <img src="https://mintcdn.com/lol-87e214d6/eTkn-8G54o6wzba3/images/setting-up-lm-studio/lmstudio-step4-1.png?fit=max&auto=format&n=eTkn-8G54o6wzba3&q=85&s=2679e60f134e7ad78f65993831568510" alt="Configure Base URL" width="1818" height="1527" data-path="images/setting-up-lm-studio/lmstudio-step4-1.png" />
    </Frame>
  </Step>

  <Step title="Use the Model">
    Select the model in Oryx agent and start using it! 🎉
  </Step>
</Steps>

<Warning>
  Ensure the Context Window Size in Oryx matches what you configured in LM
  Studio to avoid issues with long conversations.
</Warning>

## Configuration Details

<Accordion title="Default LM Studio Settings">
  * **Base URL**: `http://localhost:1234/v1/` - **Provider Type**: OpenAI
    Compatible - **Context Window**: Depends on your model and hardware (typically
    2048-32768)
</Accordion>

<Accordion title="Supported Models">
  LM Studio supports various models including: - OpenAI GPT-OSS series - LLaMA
  and derivatives - Mistral models - And many more from Hugging Face
</Accordion>