=== AI Provider for LM Studio ===
Contributors:      rtcamp, milindmore22, vishal4669, aishwarryapande, aviralmittal89
Tags:              ai, lmstudio, llm, local-ai, connector
Requires at least: 7.0
Tested up to:      7.1
Stable tag:        1.1.2
Requires PHP:      7.4
License:           GPL-2.0-or-later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Connector for LM Studio for the WordPress AI Client.

== Description ==

This plugin provides [LM Studio](https://lmstudio.ai/) integration for the WordPress AI Client. It allows you to run AI inference entirely on your own machine — connecting WordPress to a local LM Studio server with no cloud account or API key required.

**Features:**

* Connector for LM Studio registration for WordPress AI Client.
* Configure a default model for text generation from the admin settings page.
* Automatic model discovery from your running LM Studio instance.
* Text generation tasks using LM Studio's API.
* Vision-capable models, such as those used for generating alt-text, can process both text and images.
* Settings page under **Settings > LM Studio Settings**.
* Works without an API key in the default local setup.
* Extended HTTP timeout (180 s) to accommodate local model warm-up.

== Installation ==

1. Upload plugin files to `/wp-content/plugins/ai-provider-for-lm-studio/`.
2. Activate **Connector for LM Studio** through the Plugins menu in WordPress.
3. Start LM Studio and load a model.
4. Configure the host URL and default model in **Settings > LM Studio Settings**.

== Screenshots ==

1. LM Studio provider in Connectors page showing connection status and API Key field.
2. LM Studio settings page showing host URL and model selection.
3. Example of generating post title using a local LM Studio model in the WordPress editor.
4. Example of generating alt text for an image using a vision-capable model in LM Studio.

== Frequently Asked Questions ==

= Do I need an API key? =

Not by default. Connector for LM Studio local server can run without authentication.

If your LM Studio server is configured with API token authentication, set the token in **Settings > Connectors**.

= What host URL is used by default? =

The default is `http://localhost:1234`. You can change this in **Settings > LM Studio Settings** or by setting the `AI_PROVIDER_FOR_LM_STUDIO_HOST` environment variable.

= Can I change the LM Studio host URL? =

Yes. Enter the full base URL (including port) in **Settings > LM Studio Settings > Host URL**, or set the `AI_PROVIDER_FOR_LM_STUDIO_HOST` environment variable. The environment variable takes priority over the admin setting.

= Can I use vision / image-input models? =

Yes. When a model loaded in LM Studio has vision capabilities, the plugin automatically uses the multimodal input format when image parts are included in a prompt. No additional configuration is needed.

= Can this plugin generate images? =

No. LM Studio supports LLM inference only. Text-to-image (image generation) is not available through this plugin.

= Why does text generation sometimes time out? =

Loading or warming up a large model in LM Studio can take significant time. The plugin automatically extends the HTTP timeout to 180 seconds for all requests to the configured LM Studio host to accommodate this.

Additionally make sure to turn off **thinking** ability of model in LM Studio settings, as it can cause requests to hang indefinitely.

= Which models are supported? =

Any LLM-type model loaded in LM Studio is supported. Vision-capable models also support image input.

== Source Code ==

The source code is available on <a href="https://github.com/rtCamp/ai-provider-for-lm-studio">GitHub</a>.

== Changelog ==

= 1.1.2 =

* Changed env variable from LMSTUDIO_HOST to AI_PROVIDER_FOR_LM_STUDIO_HOST
* Renamed constants fro `_LMSTUDIO_` to `_LM_STUDIO_`

= 1.1.1 =
* Remove AI from required plugin header.
* Added github source code information in readme.txt
* Renames plugin to "AI Provider for LM Studio"

= 1.1.0 =
* Added updated UI for settings page and connector status in Connectors list.
* Added badages to indicate connection status in Connectors list.
* Added badages to indicate model capabilities available from endpoint when selecting default model in settings.
* Added switches to turn on/off reasoning capabilities of the model in LM Studio settings, as it can cause requests to hang indefinitely if turned on.
* Refactored javascript code to use typescript for better maintainability and type safety.
* Updated dependencies and fixed minor bugs.

= 1.0.0 =

* Initial release of the Connector for LM Studio plugin.
* LM Studio REST API model discovery and text generation support.
* Multimodal (vision) input support for vision-capable models.
* Admin settings page for host URL and default model configuration.
* Automatic localhost allowlisting and extended HTTP timeout for local inference.

== Upgrade Notice ==

= 1.1.2 =

* Renamed constants fro `_LMSTUDIO_` to `_LM_STUDIO_`
