Dario AI Connector WP Registry grade A. No security issues foundWP RegistryNo security issues foundOpen the reportA

Connects WordPress to AI models via the Dario local LLM router using the WordPress 7.0 Connectors API.

Requirements

• WordPress 7.0+
• PHP 7.4+
• Node.js 18+ if you want the plugin to manage the bundled Dario sidecar
• Or Dario running externally on an accessible host

Installation

1. Download the latest release zip from GitHub Releases
2. Upload to /wp-content/plugins/procyon-dario-provider/ or install via the WordPress plugins screen
3. Activate the plugin
4. Configure your Dario API key in Settings > Connectors

On activation, the plugin attempts to start a bundled Dario Node sidecar if Node.js is available. Disable this with:

define( 'DARIO_MANAGE_SIDECAR', false );

Configuration

Base URL

Defaults to http://localhost:3456/v1. Override with:

// wp-config.php
define( 'DARIO_BASE_URL', 'http://192.168.1.100:3456/v1' );

Or via environment variable:

DARIO_BASE_URL=http://192.168.1.100:3456/v1

Sidecar

The bundled sidecar starts @askalf/dario on 127.0.0.1:3456 by default. Override the host/port with:

define( 'DARIO_PROXY_HOST', '127.0.0.1' );
define( 'DARIO_PROXY_PORT', 3456 );

Or via environment variables:

DARIO_PROXY_HOST=127.0.0.1
DARIO_PROXY_PORT=3456

If your Node binary is not named node, set DARIO_NODE_BINARY.

Dario must be authenticated for the OS user that runs WordPress/PHP. In Lando:

lando deploy-plugin
lando dario login
lando wp plugin deactivate procyon-dario-provider
lando wp plugin activate procyon-dario-provider

If Dario is not authenticated, activation logs the failure to wp-content/dario-provider/dario-sidecar.log and leaves the plugin active.

API Key

Set via Settings > Connectors in wp-admin, or:

// wp-config.php
define( 'DARIO_API_KEY', 'your-key-here' );

Or via environment variable:

DARIO_API_KEY=your-key-here

Supported Models

The plugin provides a curated list of models that Dario commonly routes:

You can use any model name Dario supports by specifying it via using_model_preference() or custom options.

Usage

After configuration, any plugin using the WordPress AI Client can route through Dario:

$text = wp_ai_client_prompt( 'Write a haiku about WordPress.' )
    ->using_model_preference( 'claude-sonnet-4-6' )
    ->generate_text();

Development

Setup

composer install
npm ci

Tests + checks (same scripts run locally and in CI)

npm run lint         # php -l on src/+tests/, node --check on sidecar/*.mjs
npm test             # PHP unit tests (host-side, fast)
npm run check:pcp    # Plugin Check via Lando — requires `lando start` first
npm run check        # everything (lint + test + check:pcp)

CI runs the exact same scripts. PHP linting also runs via husky + lint-staged on commit.

Local dev environment

lando start          # boots WordPress + auto-installs plugin, theme, and test companions

lando start is idempotent — it sets up WordPress 7.0 RC4, the twentytwentyfive theme, and activates procyon-dario-provider, the ai consumer plugin (for end-to-end testing), and plugin-check (for PCP runs). No follow-up commands needed.

Conventional Commits

This project uses conventional commits enforced by commitlint:

feat: add new model to directory
fix: correct response parsing for streaming
chore: bump dependencies

Releases

1. Bump version in readme.txt, package.json, package-lock.json, and procyon-dario-provider.php
2. Tag and create the GitHub release: gh release create v0.2.x --generate-notes
3. The release workflow builds the zip and attaches it as a release asset

Releases live at https://github.com/procyon-creative/wp-dario-provider/releases

License

GPL-2.0-or-later