PHPackages                             filter-agency/filter-ai - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. filter-agency/filter-ai

ActiveWordpress-plugin[Utility &amp; Helpers](/categories/utility)

filter-agency/filter-ai
=======================

Powerful AI content creation tools integrated directly into the WordPress editor for effortless content generation.

1.8.0(3w ago)82.4k—7.1%3[1 issues](https://github.com/filter-agency/filter-ai/issues)[1 PRs](https://github.com/filter-agency/filter-ai/pulls)GPL-3.0PHPPHP &gt;=7.4CI passing

Since May 27Pushed 2w ago1 watchersCompare

[ Source](https://github.com/filter-agency/filter-ai)[ Packagist](https://packagist.org/packages/filter-agency/filter-ai)[ RSS](/packages/filter-agency-filter-ai/feed)WikiDiscussions main Synced yesterday

READMEChangelog (10)Dependencies (18)Versions (29)Used By (0)

Filter AI
=========

[](#filter-ai)

**Filter AI** brings the power of leading AI platforms directly into the WordPress content workflow. It uses the native WordPress AI Client on WordPress 7.0 and later, and falls back to Felix Arntz's excellent [AI Services](https://github.com/felixarntz/ai-services) plugin on earlier WordPress versions, making it simple for content teams to harness AI for everyday content tasks.

Release Notes
-------------

[](#release-notes)

### 1.8.0

[](#180)

#### Added

[](#added)

- Choose a specific AI model for each provider directly from the feature settings. Provider selections now include model-aware options such as `Anthropic (Claude) - Auto`, `Anthropic (Claude) - Claude Opus`, and `Anthropic (Claude) - Claude Haiku`.
- Keep using automatic model selection from the same `AI Provider / Model` dropdown by choosing a provider's `Auto` option, such as `Anthropic (Claude) - Auto`.
- Refresh available provider models daily and cache the last successful model catalogue, keeping stale model options visible if a refresh fails.

#### Fixed

[](#fixed)

- Prevent unsupported AI features from being enabled when no configured provider can handle the required capability, such as image generation with text-only providers.
- Move AI error logs into the Settings screen and improve admin links so failed requests are easier to review.
- Avoid queueing a brand voice scan when a brand voice prompt has already been filled.
- Improve compatibility with Anthropic responses from AI Services when tool or thinking response parts are present.

Development
-----------

[](#development)

You can either clone this repository into the plugin directory `wp-content/plugins` of your local WordPress site or work on changes within a standalone directory and then build and update the plugin manually using the generated ZIP file.

### Requirements

[](#requirements)

- [Node and NPM](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
- [Composer](https://getcomposer.org/download/)

### Install dependencies

[](#install-dependencies)

```
composer install

```

`npm install` and `npm run build` are run afterwards automatically.

### Husky

[](#husky)

Run the following once to enable [Husky](https://typicode.github.io/husky/) locally:

```
npm run prepare

```

### Run locally

[](#run-locally)

Serve the plugin so any changes are automatically built:

```
npm run start

```

### Testing environments

[](#testing-environments)

Use Playground first for quick demos, activation smoke checks, and admin UI review:

```
npm run playground:demo
npm run playground:smoke

```

Use Docker when MySQL/MariaDB parity matters, including activation, uninstall/reinstall, update routines, API integration boundaries, and release candidates:

```
npm run docker:start:wp70
npm run docker:seed:wp70
npm run docker:start:wp69
npm run docker:seed:wp69
npm run docker:reset

```

The WordPress 7.0 compose stack runs at `http://localhost:8070`; the WordPress 6.9 stack runs at `http://localhost:8069` and installs AI Services for the legacy backend path. Both use `admin` / `password`.

See `playground/README.md` and `docker/README.md` for the split between the fast Playground path and the MariaDB-backed parity path.

### Build

[](#build)

Type check, and build the plugin:

```
npm run build

```

### ZIP

[](#zip)

To package the plugin so it can be installed within WordPress:

```
npm run plugin-zip

```

Usage
-----

[](#usage)

Filter AI uses the native WordPress AI Client when running on WordPress 7.0 or later with configured AI provider connectors. On earlier WordPress versions, Filter AI uses the [AI Services](https://wordpress.org/plugins/ai-services/) plugin, which should be automatically installed if not already present.

Once Filter AI is active you should see a menu item in the admin menu which gives you access to the settings and batch capabilities.

Throughout the WordPress admin look for the Filter AI button within the content toolbars.

[![Filter AI button](src/assets/filter-ai-logo.svg)](src/assets/filter-ai-logo.svg)

Feedback
--------

[](#feedback)

We welcome feedback whether you have a question, found a bug or thought of a great new feature. Please [open an issue](https://github.com/filter-agency/filter-ai/issues/new) to let us know.

Contributing
------------

[](#contributing)

First off, thank you for your interest in contributing to Filter AI.

If you do decide to contribute to this plugin, please abide by the [WordPress Code of Conduct](https://make.wordpress.org/handbook/community-code-of-conduct/) and follow the [WordPress Coding Standards and best practices](https://developer.wordpress.org/coding-standards/). Anything that you do submit will be released under the [GPLv3 license](LICENSE).

When you commit a change, Husky will run the following:

- WordPress coding standards check
- type check
- lint-staged will prettify the staged files

About Filter
------------

[](#about-filter)

[Filter](https://filter.agency/) is a leading digital agency dedicated to creating innovative solutions that help businesses leverage technology effectively. We're deeply invested in helping businesses leverage AI effectively, developing custom solutions that solve real business challenges.

Our approach to AI focuses on practical, implementable solutions that solve real business challenges – and Filter AI embodies this philosophy perfectly. By making AI accessible within the familiar WordPress environment, we're helping content teams work more efficiently without sacrificing quality or control.

Check out our other WordPress plugin, [PersonalizeWP](https://personalizewp.com/), which allows you to display personalised content on your WordPress website using the Block Editor.

###  Health Score

50

—

FairBetter than 95% of packages

Maintenance95

Actively maintained with recent releases

Popularity30

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 62.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~27 days

Recently: every ~9 days

Total

15

Last Release

21d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3172392?v=4)[Paul Halfpenny](/maintainers/paulhalfpenny)[@paulhalfpenny](https://github.com/paulhalfpenny)

---

Top Contributors

[![robertmeacher](https://avatars.githubusercontent.com/u/78855660?v=4)](https://github.com/robertmeacher "robertmeacher (393 commits)")[![paulhalfpenny](https://avatars.githubusercontent.com/u/3172392?v=4)](https://github.com/paulhalfpenny "paulhalfpenny (88 commits)")[![GHFilter](https://avatars.githubusercontent.com/u/215365670?v=4)](https://github.com/GHFilter "GHFilter (87 commits)")[![filter-david](https://avatars.githubusercontent.com/u/122270037?v=4)](https://github.com/filter-david "filter-david (25 commits)")[![filter-ian](https://avatars.githubusercontent.com/u/104220758?v=4)](https://github.com/filter-ian "filter-ian (20 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (8 commits)")[![carronmedia](https://avatars.githubusercontent.com/u/1378815?v=4)](https://github.com/carronmedia "carronmedia (6 commits)")[![felixarntz](https://avatars.githubusercontent.com/u/3531426?v=4)](https://github.com/felixarntz "felixarntz (1 commits)")

---

Tags

aireactwordpresswordpressplugin

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/filter-agency-filter-ai/health.svg)

```
[![Health](https://phpackages.com/badges/filter-agency-filter-ai/health.svg)](https://phpackages.com/packages/filter-agency-filter-ai)
```

###  Alternatives

[helsingborg-stad/municipio

A bootstrap theme for creating municipality sites.

4028.5k10](/packages/helsingborg-stad-municipio)[mediawiki/maps

Adds various mapping features to MediaWiki

84152.3k3](/packages/mediawiki-maps)[starcitizentools/citizen-skin

A beautiful, usable, responsive MediaWiki skin with in-depth extension support. Originally developed for the Star Citizen Wiki.

3376.6k](/packages/starcitizentools-citizen-skin)[civicrm/civicrm-drupal-8

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

19251.4k3](/packages/civicrm-civicrm-drupal-8)[altis/core

Core module for Altis

19228.0k3](/packages/altis-core)[pfefferle/wordpress-activitypub

The ActivityPub protocol is a decentralized social networking protocol based upon the ActivityStreams 2.0 data format.

5721.7k4](/packages/pfefferle-wordpress-activitypub)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
