PHP download

Download the PHP package modelslab/modelq without Composer

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

Table of contents
Download modelslab/modelq
More information about modelslab/modelq
Files in modelslab/modelq

Vendor modelslab
Package modelq
Short Description A lightweight PHP task queue library, alternative to traditional queue systems, optimized for ML inference workloads
License MIT

Keywords redis queue async worker inference ml machine-learning task-queue

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 modelslab/modelq

Informations about the package modelq

ModelQ PHP

A lightweight PHP task queue library, alternative to traditional queue systems, optimized for ML inference workloads.

Features

Simple API - Easy to use task registration and enqueueing
Redis-backed - Fast and reliable task storage using Redis
Streaming Support - Real-time streaming results for long-running tasks
Remote Workers - Connect PHP frontend to Python GPU workers via Redis
Middleware Hooks - Lifecycle hooks for monitoring and customization
Delayed Tasks - Schedule tasks to run after a delay
CLI Tools - Built-in commands for queue management
ML Optimized - Designed for machine learning inference workloads

Use Case: PHP Frontend + Python GPU Worker

ModelQ PHP is designed to work seamlessly with Python ModelQ workers running on GPU servers. This enables you to:

Run your PHP web application on standard servers
Offload ML inference tasks to dedicated GPU servers running Python
Share a managed Redis instance (AWS ElastiCache, GCP Memorystore, etc.)

Python Worker (GPU Server)

PHP Frontend (Web Server)

See examples/remote_worker.php for a complete example.

Requirements

PHP 8.1 or higher
Redis server
phpredis extension (ext-redis)

Installation

Make sure you have the phpredis extension installed:

Quick Start

1. Create a Worker

2. Enqueue Tasks

Usage

Basic Task Registration

Enqueueing Tasks

Custom Task IDs

By default, ModelQ generates a UUID for each task. You can provide your own task ID to correlate tasks with your database records:

This is useful when you want to:

Track tasks using your existing database primary keys
Easily correlate queue tasks with database records
Look up task status without storing the generated UUID

Streaming Tasks

For tasks that produce incremental output (like ML text generation):

Queue Management

Task History & Monitoring

Track past tasks, view errors, and monitor remote workers:

Worker Info

Get detailed information about registered workers including system resources (CPU, RAM, GPU):

Worker info includes:

worker_id - Unique worker identifier
status - Current status (idle, busy)
allowed_tasks - List of tasks this worker handles
last_heartbeat - Unix timestamp of last heartbeat
hostname - Worker hostname
os - Operating system info
python_version - Python version (for Python workers)
php_version - PHP version (for PHP workers)
system_info - Detailed CPU, RAM, and GPU information

Delayed Tasks

Middleware

Create custom middleware for lifecycle hooks:

Custom Redis Client

Error Handling

CLI Commands

ModelQ includes CLI commands for queue management:

The app.php file should return a configured ModelQ instance:

Configuration Options

Task Options

Architecture

Redis Keys

ModelQ uses the following Redis keys:

Key Pattern	Type	Description
`task_queue`	List	Main task queue
`task:{id}`	String	Task data
`task_result:{id}`	String	Task result
`task_stream:{id}`	Stream	Streaming task output
`servers`	Hash	Registered worker servers
`processing_tasks`	Set	Currently processing tasks
`delayed_tasks`	Sorted Set	Delayed tasks (score = execution time)

Testing

Examples

Check the examples/ directory for complete working examples:

examples/basic_usage.php - Basic task queue operations
examples/producer.php - Enqueueing tasks and getting results
examples/worker.php - Worker process setup
examples/streaming_example.php - Streaming task example
examples/middleware_example.php - Custom middleware usage
examples/queue_management.php - Queue management operations
examples/remote_worker.php - PHP + Remote Python GPU Worker

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Related Projects

ModelQ Python - The original Python implementation

All versions of modelq with dependencies

PHP Build Version

Package Version

Version 1.1 Release 20. Aug 2026
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of modelq from vendor modelslab

Requires php Version ^8.1
ext-redis Version *
symfony/console Version ^6.0|^7.0
psr/log Version ^3.0

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 modelslab/modelq contains the following files

Loading the files please wait ...