wordpress / php-ai-client
A provider agnostic PHP AI client SDK to communicate with any generative AI models of various capabilities using a uniform API.
Installs: 68
Dependents: 0
Suggesters: 0
Security: 0
Stars: 139
Watchers: 12
Forks: 18
Open Issues: 17
Requires
- php: >=7.4
- ext-json: *
- php-http/discovery: ^1.0
- php-http/httplug: ^2.0
- php-http/message-factory: ^1.0
- psr/http-client: ^1.0
- psr/http-factory: ^1.0
- psr/http-message: ^1.0 || ^2.0
Requires (Dev)
- dealerdirect/phpcodesniffer-composer-installer: ^1.0
- guzzlehttp/psr7: ^1.0 || ^2.0
- php-http/curl-client: ^2.0
- php-http/mock-client: ^1.0
- phpcompatibility/php-compatibility: dev-develop
- phpstan/phpstan: ~2.1
- phpunit/phpunit: ^9.5 || ^10.0
- slevomat/coding-standard: ^8.20
- squizlabs/php_codesniffer: ^3.7
- dev-trunk
- 0.1.0
- dev-adds-message-builder
- dev-enhance/get-provider-ids
- dev-fix/empty-tool-calls-parameters
- dev-add/agentsmd
- dev-add/props-bot
- dev-prepare/0.1.0
- dev-php-74-compat
- dev-prompt-builder-using-config
- dev-no-more-system-messages
- dev-add/message-part-channel
- dev-ai-client
- dev-test/install-provider-sdks
This package is auto-updated.
Last update: 2025-09-02 20:51:49 UTC
README
Part of the AI Building Blocks for WordPress initiative
A provider agnostic PHP AI client SDK to communicate with any generative AI models of various capabilities using a uniform API.
General information
This project is a PHP SDK, which can be installed as a Composer package. In WordPress, it could be bundled in plugins. It is however not a plugin itself.
While this project is stewarded by WordPress AI Team members and contributors, it is technically WordPress agnostic. The gap the project addresses is relevant for not only the WordPress ecosystem, but the overall PHP ecosystem, so any PHP project could benefit from it. There is also no technical reason to scope it to WordPress, as communicating with AI models and their providers is independent of WordPress's built-in APIs and paradigms.
Installation
composer require wordpress/php-ai-client
Code examples
Text generation using a specific model
use WordPress\AiClient\AiClient; $text = AiClient::prompt('Write a 2-verse poem about PHP.') ->usingModel(Google::model('gemini-2.5-flash')) ->generateText();
Text generation using any compatible model from a specific provider
use WordPress\AiClient\AiClient; $text = AiClient::prompt('Write a 2-verse poem about PHP.') ->usingProvider('openai') ->generateText();
Text generation using any compatible model
use WordPress\AiClient\AiClient; $text = AiClient::prompt('Write a 2-verse poem about PHP.') ->generateText();
Text generation with additional parameters
use WordPress\AiClient\AiClient; $text = AiClient::prompt('Write a 2-verse poem about PHP.') ->usingSystemInstruction('You are a famous poet from the 17th century.') ->usingTemperature(0.8) ->generateText();
Text generation with multiple candidates using any compatible model
use WordPress\AiClient\AiClient; $texts = AiClient::prompt('Write a 2-verse poem about PHP.') ->generateTexts(4);
Image generation using any compatible model
use WordPress\AiClient\AiClient; $imageFile = AiClient::prompt('Generate an illustration of the PHP elephant in the Caribbean sea.') ->generateImage();
See the PromptBuilder
class and its public methods for all the ways you can configure the prompt.
More documentation is coming soon.
Further reading
For more information on the requirements and guiding principles, please review:
See the contributing documentation for more information on how to get involved.