1tomany/llm-sdk

A single, unified, framework-independent library for integration with many popular AI platforms and large language models

v0.7.3 2026-03-17 19:13 UTC

Requires

• php: >=8.4
• ext-fileinfo: *
• fakerphp/faker: ^1.24
• phpdocumentor/reflection-docblock: ^5.6
• psr/container: ^2.0
• symfony/http-client: ^7.2|^8.0
• symfony/property-access: ^7.2|^8.0
• symfony/property-info: ^7.2|^8.0
• symfony/serializer: ^7.2|^8.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.93
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^12.5

MIT

• Vic Cherubini

• ai
• Gemini
• ai client
• openai
• ChatGpt
• gpt
• llm
• Open AI
• claude
• AI SDK
• chat gpt
• llm client
• llm sdk

README

This library provides a single, unified, framework-independent library for integration with several popular AI platforms and large language models.

Installation

Install the library using Composer:

composer require 1tomany/llm-sdk

Usage

There are two ways to use this library:

1. Direct Instantiate the AI client you wish to use and send a request object to it. This method is easier to use, but comes with the cost that your application will be less flexible and testable.
2. Actions Register the clients you wish to use with a OneToMany\LlmSdk\Factory\ClientFactory instance, inject that instance into each action you wish to take, and interact with the action instead of through the client.

Note: A Symfony bundle is available if you wish to integrate this library into your Symfony applications with autowiring and configuration support.

You can learn how to use this library by reviewing the examples below while I'm working on thoroughly documenting it.

Examples

• examples/files/upload.php Uploads a file to an LLM vendor
• examples/files/deletes.php Deletes a file from an LLM vendor
• examples/embeddings/create.php Creates an embedding vector from a prompt sent to an LLEM (large language embedding model)
• examples/outputs/generate.php Generates output from a prompt sent to an LLM

Supported platforms

• Anthropic
• Gemini
• Mock
• OpenAI

Platform feature support

Note: Each platform refers to generating output (inference) differently; OpenAI uses the word "Responses" while Gemini uses the word "Content". I've decided the word "Output" best represents what a large language model produces in the case of generative models, and "Embedding" in the case of embedding models.

To generate output or create an embedding, you must first compile a "Query". A query is made up of different input components: text prompts, files, a JSON schema, and/or system instructions.

This library allows you to compile a query before sending it to the model for two reasons:

1. You can log/analyze the request payload before sending it to the model.
2. You can compile individual requests for batching.

Feature	Anthropic	Gemini	Mock	OpenAI
Batches
Create	❌	✅	✅	✅
Read	❌	✅	✅	✅
Cancel	❌	❌	❌	❌
Embeddings
Create	❌	✅	✅	✅
Files
Upload	✅	✅	✅	✅
Read	❌	❌	❌	❌
List	❌	❌	❌	❌
Download	❌	❌	❌	❌
Delete	✅	✅	✅	✅
Outputs
Generate	❌	✅	✅	✅
Queries
Compile	❌	✅	✅	✅

Credits

• Vic Cherubini, 1:N Labs, LLC

License

The MIT License