Download the PHP package meirdick/prism-workers-ai without Composer

On this page you can find all versions of the php package meirdick/prism-workers-ai. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of meirdick/prism-workers-ai

Informations about the package prism-workers-ai

Prism Workers AI

Cloudflare Workers AI provider for Prism PHP and Laravel AI SDK — routes through the AI Gateway /compat endpoint.

Works with both Prism::text()->using('workers-ai', ...) and agent()->prompt(provider: 'workers-ai').

Why this package?

Workers AI's OpenAI-compatible /compat endpoint has subtle differences from the OpenAI API that break Prism's built-in xAI driver:

  1. Array content format — The xAI MessageMap wraps user content in [{type: "text", text: "..."}]. Workers AI expects a plain string.
  2. Structured output type mismatch — /compat may return content as a JSON object instead of a string, causing TypeError crashes.
  3. Missing content field — Workers AI requires content to always be present on assistant messages, even when empty (tool call responses).
  4. No embeddings — The xAI driver doesn't support embeddings. This package does.

Installation

The service provider is auto-discovered by Laravel. No additional setup needed.

Configuration

Prism PHP (config/prism.php)

Laravel AI SDK (config/ai.php)

Environment

Note: The URL must end in /compat, not /workers-ai/v1. The SDK appends /chat/completions automatically.

Create a Cloudflare API token with Workers AI: Read permission at dash.cloudflare.com/profile/api-tokens.

Understanding the workers-ai/ model prefix

The AI Gateway has two OpenAI-compatible endpoints for Workers AI:

Endpoint URL Model format
Universal (recommended) .../compat workers-ai/@cf/meta/...
Provider-specific .../workers-ai/v1 @cf/meta/...

This package targets the /compat endpoint. The workers-ai/ prefix in model names tells the gateway which provider to route to. The gateway strips the prefix internally — responses return just @cf/....

Usage

With Prism PHP

With Laravel AI SDK

Recommended Models

Model Use Case
workers-ai/@cf/moonshotai/kimi-k2.5 Frontier — smartest (256K context, reasoning, vision, tool calling)
workers-ai/@cf/meta/llama-3.3-70b-instruct-fp8-fast General purpose (best quality/speed)
workers-ai/@cf/qwen/qwen3-30b-a3b-fp8 Efficient MoE (30B total / 3B active, 32K context)
workers-ai/@cf/zai-org/glm-4.7-flash Long document summarization (131K context)
workers-ai/@cf/meta/llama-3.1-8b-instruct Fast/cheap tasks
workers-ai/@cf/qwen/qwq-32b Reasoning
workers-ai/@cf/qwen/qwen2.5-coder-32b-instruct Code generation
workers-ai/@cf/baai/bge-large-en-v1.5 Embeddings (1024 dimensions)
workers-ai/@cf/qwen/qwen3-embedding-0.6b Embeddings (1024 dimensions, 4096 input tokens)
workers-ai/@cf/google/embeddinggemma-300m Embeddings (768 dimensions, low-latency)

Embedding dimensions: Most embedding models output 1024 dimensions. If using embeddinggemma-300m (768 dims), set models.embeddings.dimensions to 768 in your config/ai.php provider config.

Reasoning models: Kimi K2.5 is a thinking model — it reasons before answering. Set withMaxTokens(2000) or higher, as reasoning tokens count against the limit. The thinking chain is available in $response->steps[0]->additionalContent['thinking'].

All model names must be prefixed with workers-ai/ when routing through AI Gateway, so the gateway knows which provider to route to.

Known quirks of the /compat endpoint

Cloudflare's OpenAI-compatibility layer has one notable deviation from the OpenAI spec that this package handles internally, but is worth knowing about if you're writing your own handlers against the same endpoint:

Compatibility

Dependency Supported Notes
prism-php/prism ^0.99 \|\| ^0.100 Full Prism support — Prism::text()/structured()/embeddings()/stream() all work on every supported version.
laravel/ai ^0.3 – ^0.5 ✅ Full support agent()->prompt(provider: 'workers-ai') works via the PrismGateway subclass.
laravel/ai ^0.6 ⚠️ Prism-only Upstream removed PrismGateway. The Laravel AI bridge auto-disables with a one-time Log::warning; Prism standalone keeps working. agent()->prompt(provider: 'workers-ai') will throw until v0.5.0 ships.

The v0.6 gap and v0.5.0 plan

laravel/ai v0.6 removed the PrismGateway class this package extended, so the agent() integration degrades on that line. If you need agent()->prompt() today, stay on laravel/ai ^0.5 — this package on v0.4.x keeps it working there.

prism-workers-ai v0.5.0 (upcoming) will restore full agent() support on laravel/ai ^0.6+ by shipping a native Laravel AI gateway, based on the design in laravel/ai#405. The constructor of PrismWorkersAi\LaravelAi\WorkersAiProvider will change in that release — a minor BC break that only affects the small subset of users subclassing it directly.

See UPGRADING.md for the migration path as it firms up.

How it works

The package registers a workers-ai provider at two levels:

  1. Prism layer — via PrismManager::extend(), handling the actual HTTP requests with correct content formatting
  2. Laravel AI SDK layer — via AiManager::extend(), bridging the workers-ai driver to the Prism provider

The Laravel AI SDK bridge includes a PrismGateway subclass that overrides configure() to pass the driver name as a string to Prism, bypassing the SDK's hardcoded provider enum mapping. This override auto-disables itself when laravel/ai adds native support for custom Prism providers (laravel/ai#283, laravel/ai#284).

Automated Setup

For a fully automated setup — including AI Gateway routing, environment configuration, and Workers AI registration — use the laravel-cloudflare-ai-gateway Claude Code skill:

It handles installing this package, configuring your gateway URL, and wiring up all providers in a single guided workflow.

Testing

License

MIT

All versions of prism-workers-ai with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
prism-php/prism Version ^0.99 || ^0.100
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package meirdick/prism-workers-ai contains the following files

Loading the files please wait ...