> ## 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.

# LM Studio

> Run local models with LM Studio in Agno agents.

[LM Studio](https://lmstudio.ai) runs open-source models locally through a desktop app with an OpenAI-compatible local server.

LM Studio supports multiple open-source models. See the library [here](https://lmstudio.ai/models).

We recommend experimenting to find the best-suited model for your use case. Here are some general recommendations:

* `llama3.3` models are good for most basic use cases.
* `qwen` models perform specifically well with tool use.
* `deepseek-r1` models have strong reasoning capabilities.
* `phi4` models offer strong performance at a small size.

## Set up a model

Install [LM Studio](https://lmstudio.ai), download the model you want to use, and run it.

## Example

After you have the model locally, use the `LMStudio` model class to access it. It uses the OpenAI client, so install the `openai` package:

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

```python agent.py theme={null}
from agno.agent import Agent
from agno.models.lmstudio import LMStudio

agent = Agent(
    model=LMStudio(id="qwen2.5-7b-instruct-1m"),
    markdown=True
)

# Print the response in the terminal
agent.print_response("Share a 2 sentence horror story.")
```

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

## Params

| Parameter | Type | Default | Description |
| - | - | - | - |
| `id` | `str` | `"qwen2.5-7b-instruct-1m"` | The id of the LMStudio model to use |
| `name` | `str` | `"LMStudio"` | The name of the model |
| `provider` | `str` | `"LMStudio"` | The provider of the model |
| `api_key` | `Optional[str]` | `"not-provided"` | The API key for LMStudio (usually not needed for local) |
| `base_url` | `str` | `"http://127.0.0.1:1234/v1"` | The base URL for the local LMStudio server |

`LMStudio` is a subclass of the [OpenAILike](https://agno-v2.mintlify.site/models/providers/openai-like.md) class and has access to the same params.


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