1tomany/php-ai-bundle

Symfony bundle that provides bindings for the 1tomany/php-ai package

v0.1.0 2026-08-29 22:48 UTC

Requires

• php: >=8.5
• 1tomany/php-ai: ~0.1.0
• symfony/framework-bundle: ^7.2|^8.0|^8.1

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.93
• phpstan/phpstan: ^2.1.55
• phpunit/phpunit: ^13.1.11

MIT

• Vic Cherubini

Published on Packagist.org on 2026-08-29 22:48 UTC

README

This package wraps the 1tomany/php-ai library into an easy to use Symfony bundle.

Installation

Install the bundle using Composer:

composer require 1tomany/php-ai-bundle

Configuration

To change the default configuration, create a file named onetomany_ai.yaml in config/packages/ with the following contents and adjust accordingly:

onetomany_ai:
    transport:
        http_client: http_client

    gemini:
        api_key: "%env(GEMINI_API_KEY)%"
        api_version: v1beta

    openai:
        api_key: "%env(OPENAI_API_KEY)%"
        api_version: v1

The transport uses Symfony's http_client service by default, so the transport block can normally be omitted. The bundle registers its provider-specific query normalizers with Symfony's serializer service and injects that serializer into the transport and providers.

Provider blocks are optional. If a provider block is omitted, that provider is not registered with the OneToMany\AI\AiClient facade.

Usage

Inject the OneToMany\AI\Contract\AiClientInterface facade and use its resources:

<?php

use OneToMany\AI\Contract\AiClientInterface;
use OneToMany\AI\Model;
use OneToMany\AI\Resource\File\LocalFile;
use OneToMany\AI\Resource\Prompt\InputFile;
use OneToMany\AI\Resource\Prompt\Prompt;
use OneToMany\AI\Vendor;

use function sprintf;

final readonly class AnalyzeFile
{
    public function __construct(
        private AiClientInterface $aiClient,
    ) {
    }

    public function __invoke(string $path): string
    {
        // Upload a file to the LLM vendor
        $localFile = new LocalFile($path);

        $remoteFile = $this->aiClient->files->upload(
            vendor: Vendor::OpenAI,
            file: $localFile,
        );

        $prompt = Prompt::create(
            'gpt-5.4',
            'Summarize this file.',
            new InputFile(
                $remoteFile->getId(),
                $localFile->getType(),
            ),
        );

        // Compile a prompt into a query and send it
        $response = $this->aiClient->prompts->send($prompt);

        if (null !== $response->getError()) {
            throw new \RuntimeException(sprintf('Error: %s.', $response->getError()));
        }

        if (null !== $response->getRefusal()) {
            throw new \RuntimeException(sprintf('Refusal: %s.', $response->getRefusal()));
        }

        if (null === $response->getText()) {
            throw new \RuntimeException('Query failed to generate output.');
        }

        return $response->getText();
    }
}

Credits

• Vic Cherubini, 1:N Labs, LLC

License

The MIT License