=== AI Provider for Ollama ===
Contributors:      fueled, 10up, dkotter, jeffpaul
Tags:              ai, ollama, llm, local-ai, connector
Requires at least: 7.0
Tested up to:      7.1
Stable tag:        1.3.0
Requires PHP:      7.4
License:           GPL-2.0-or-later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Ollama provider for the WordPress AI Client.

== Description ==

This plugin provides [Ollama](https://ollama.com/) integration for the WordPress AI Client. It lets WordPress sites use large language models running locally or on a remote Ollama instance for text, image, and embedding generation and other AI capabilities.

Ollama exposes an [OpenAI-compatible API](https://ollama.com/blog/openai-compatibility), and this provider uses that API to communicate with any model you have pulled into Ollama (Llama, Mistral, Gemma, Phi, and many more).

**Features:**

* Text generation with any Ollama model
* Image generation with supported models
* Embedding generation with any embedding-capable Ollama model
* Typed decisions (choice, yes/no probability, and score) with local decision models such as nimble and tev1
* Automatic model discovery from your Ollama instance
* Function calling support
* Structured output (JSON mode) support
* Settings page for host URL and seeing available models
* Works without an API key for local instances

**Requirements:**

* PHP 7.4 or higher
* WordPress 7.0 or higher
* Ollama running locally or on a remote server (like Ollama Cloud)

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/ai-provider-for-ollama/`.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to **Settings > Ollama** to configure the host URL and see available models.

== Frequently Asked Questions ==

= How do I install Ollama? =

Visit [ollama.com](https://ollama.com/) to download and install Ollama for your platform. Once installed, pull a model (example `ollama pull llama3.2`) and the provider will automatically discover it.

= Do I need an API key? =

No. For local Ollama instances, no API key is needed. The plugin automatically handles authentication for local setups.

For remote Ollama instances that require authentication, enter the API key in the **Settings > Connectors** screen. If using Ollama Cloud, you also need to set your Ollama host URL in the **Settings > Ollama** screen to `https://ollama.com`.

= How do I change the Ollama host URL? =

By default, the provider connects to `http://localhost:11434`. You can change this in two ways:

1. Set the `OLLAMA_HOST` environment variable (takes precedence).
2. Go to **Settings > Ollama** in the WordPress admin and enter your host URL.

= Where do I report security bugs found in this plugin? =

Please report security bugs found in the source code of the AI Provider for Ollama plugin through the [Patchstack Vulnerability Disclosure  Program](https://patchstack.com/database/vdp/b715f2ba-e67f-437c-9398-cb523702a7ad). The Patchstack team will assist you with verification, CVE assignment, and notify the developers of this plugin.

== Screenshots ==

1. Settings > Ollama screen showing available AI models and Host URL configuration.

== Changelog ==

= 1.3.0 - 2026-10-13 =

**Added**

- Support for Jev-style decision models ([#103](https://github.com/Fueled/ai-provider-for-ollama/pull/103)).
- `ai_provider_for_ollama_request_timeout` and `ai_provider_for_ollama_connect_timeout` filters to override Ollama request and connect timeouts ([#89](https://github.com/Fueled/ai-provider-for-ollama/pull/89)).

**Changed**

- Optimized Ollama model discovery and availability checks by caching model details, reducing redundant `/api/show` requests, and adding separate timeouts for discovery requests ([#100](https://github.com/Fueled/ai-provider-for-ollama/pull/100)).

**Fixed**

- Ensure we only declare function calling support on models that advertise support for tools ([#94](https://github.com/Fueled/ai-provider-for-ollama/pull/94)).

= 1.2.0 - 2026-08-18 =

**Added**

- Support for generating embeddings (props [@dkotter](https://github.com/dkotter) via [#69](https://github.com/Fueled/ai-provider-for-ollama/pull/69)).

**Changed**

- Bumped WordPress tested-up-to version 7.1 (props [@jeffpaul](https://github.com/jeffpaul), [@dkotter](https://github.com/dkotter) via [#81](https://github.com/Fueled/ai-provider-for-ollama/pull/81)).

= 1.1.1 - 2026-05-14 =

**Added**
- Ensure the AI plugin sees Ollama as a valid, connected provider within the status dashboard widget (props [@dkotter](https://github.com/dkotter), [@jeffpaul](https://github.com/jeffpaul) via [#55](https://github.com/Fueled/ai-provider-for-ollama/pull/55)).

**Fixed**
- More robust path inclusion for the logo (props [@dkotter](https://github.com/dkotter), [@abcdatos](https://profiles.wordpress.org/abcdatos/) via [#61](https://github.com/Fueled/ai-provider-for-ollama/pull/61)).

= 1.1.0 - 2026-04-23 =

* **Added:** Support for image generation when using compatible models (props [@milindmore22](https://github.com/milindmore22), [@dkotter](https://github.com/dkotter) via [#30](https://github.com/Fueled/ai-provider-for-ollama/pull/30)).
* **Added:** Integrate with the `wpai_has_ai_credentials` filter to ensure the AI plugin sees Ollama as a valid, connected provider (props [@dkotter](https://github.com/dkotter), [@jeffpaul](https://github.com/jeffpaul) via [#43](https://github.com/Fueled/ai-provider-for-ollama/pull/43)).
* **Added:** Show the capabilities of each model next to the model name on our settings page (props [@dkotter](https://github.com/dkotter), [@jeffpaul](https://github.com/jeffpaul) via [#51](https://github.com/Fueled/ai-provider-for-ollama/pull/51)).
* **Changed:** Increase the standard timeout to be 60 seconds for text generation (props [@dkotter](https://github.com/dkotter), [@jeffpaul](https://github.com/jeffpaul) via [#49](https://github.com/Fueled/ai-provider-for-ollama/pull/49)).
* **Fixed:** Properly parse structured outputs (props [@dkotter](https://github.com/dkotter), [@jeffpaul](https://github.com/jeffpaul) via [#49](https://github.com/Fueled/ai-provider-for-ollama/pull/49)).

[View historical changelog details here](https://github.com/Fueled/ai-provider-for-ollama/blob/develop/CHANGELOG.md).

== Upgrade Notice ==

= 1.0.0 =

Initial release.
