Download the PHP package utopia-php/agents without Composer

On this page you can find all versions of the php package utopia-php/agents. 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 utopia-php/agents

Informations about the package agents

Utopia Agents

Build Status Total Downloads Discord

Utopia Agents is a simple and lite library for building and managing AI agents in PHP applications. This library provides a collection of tools and utilities for creating, managing, and orchestrating AI agents with support for multiple AI providers. This library is maintained by the Appwrite team.

Although this library is part of the Utopia Framework project it is dependency free and can be used as standalone with any other PHP project or framework.

Getting Started

Install using composer:

System Requirements

Utopia Framework requires PHP 8.0 or later. We recommend using the latest PHP version whenever possible.

Features

Usage

Basic Example

Using Different AI Providers

OpenAI

Available OpenAI Models:

Anthropic

Available Anthropic Models:

Deepseek

Available Deepseek Models:

Perplexity

Available Perplexity Models:

XAI

Available XAI Models:

OpenRouter

Managing Conversations

Streaming Responses (SSE)

The conversation layer supports incremental output streaming through Conversation::listen(callable $listener).
The callback receives each text delta as it arrives from the provider's SSE stream, while send() still returns the final aggregated Message.

Streaming in CLI / Worker Contexts

Exposing Model Output as HTTP SSE

Operational Notes

Working with Messages

Attachment Examples

Attachment Limits and Validation

Attachment validation is enforced by default in Conversation::message(...). Guardrail values come from the selected adapter (not from conversation-level user configuration).

Default adapter guardrails:

To customize limits, create an adapter subclass and override limit methods:

Schema and Schema Objects

You can use the Schema class to define a schema for a structured output. The Schema class utilizes SchemaObjects to define each property of the schema, following the JSON Schema format.

Tests

To run all unit tests, use the following Docker command:

To run static code analysis, use the following Psalm command:

Security

We take security seriously. If you discover any security-related issues, please email [email protected] instead of using the issue tracker.

Contributing

All code contributions - including those of people having commit access - must go through a pull request and be approved by a core developer before being merged. This is to ensure a proper review of all the code.

We truly ❤️ pull requests! If you wish to help, you can learn more about how you can contribute to this project in the contribution guide.

Copyright and license

The MIT License (MIT) http://www.opensource.org/licenses/mit-license.php

All versions of agents with dependencies

PHP Build Version
Package Version
Requires php Version >=8.3
utopia-php/fetch Version ^1.1.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 utopia-php/agents contains the following files

Loading the files please wait ...