PHPackages                             endritvs/laravel-ai-toolkit - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. endritvs/laravel-ai-toolkit

ActiveLibrary[Utility & Helpers](/categories/utility)

endritvs/laravel-ai-toolkit
===========================

A comprehensive AI toolkit for Laravel applications that integrates with popular AI models like OpenAI's GPT and AWS's Claude.

v1.0.6(1y ago)17272[1 PRs](https://github.com/endritvs/laravel-ai-toolkit/pulls)MITPHPPHP >=8.1

Since Sep 5Pushed 1y ago1 watchersCompare

[ Source](https://github.com/endritvs/laravel-ai-toolkit)[ Packagist](https://packagist.org/packages/endritvs/laravel-ai-toolkit)[ RSS](/packages/endritvs-laravel-ai-toolkit/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (3)Versions (3)Used By (0)

Laravel AI Toolkit 🧠
====================

[](#laravel-ai-toolkit-)

Laravel AI Toolkit is a powerful package designed to seamlessly integrate AI models, such as OpenAI's GPT and AWS's Claude, into your Laravel application. With an easy-to-use interface, this toolkit empowers developers to effortlessly add AI-driven features to their projects.

🚀 Features
----------

[](#-features)

- Simple integration with OpenAI and AWS Claude.
- Configurable AI providers.
- Customizable query builder for AI models.
- Exception handling and error reporting.
- Support for multiple AI models and providers, with fallback capabilities.

📋 Requirements
--------------

[](#-requirements)

- PHP 8.1 or higher
- Laravel 10.x to 11.x
- `openai-php/laravel` package
- `aws/aws-sdk-php` package

🛠️ Installation
---------------

[](#️-installation)

To install the package, use Composer:

```
composer require endritvs/laravel-ai-toolkit
```

After installing the package, publish the configuration file:

```
php artisan vendor:publish --provider="Endritvs\LaravelAIToolkit\AIServiceProvider" --tag="config"
```

This will create a configuration file at `config/ai.php`.

⚙️ Configuration
----------------

[](#️-configuration)

### Environment Variables

[](#environment-variables)

Ensure that you set up the following environment variables in your `.env` file:

```
# OpenAI Configuration
OPENAI_API_KEY=your-openai-api-key
GPT_MODEL="gpt-4o-mini"
GPT_MAX_TOKENS=4000

# Default Provider
AI_DEFAULT_PROVIDER="claude"

# Claude AI Configuration
CLAUDE_MAX_TOKENS=6000
CLAUDE_MODEL="anthropic.claude-v2"

# AWS Configuration
AWS_ACCESS_KEY_ID=your-aws-access-key
AWS_SECRET_ACCESS_KEY=your-aws-secret-key
AWS_REGION=us-west-2
```

### Configuration File

[](#configuration-file)

The `config/ai.php` configuration file contains default settings for the package. You can customize these settings as needed:

```
return [

    'default_provider' => env('AI_DEFAULT_PROVIDER', 'claude'),

    'providers' => [
        'gpt' => [
            'class' => \Endritvs\LaravelAIToolkit\Providers\GPTProvider::class,
            'model' => env('GPT_MODEL', 'gpt-4o-mini'),
            'max_tokens' => env('GPT_MAX_TOKENS', 4000),
        ],
        'claude' => [
            'class' => \Endritvs\LaravelAIToolkit\Providers\ClaudeProvider::class,
            'model' => env('CLAUDE_MODEL', 'anthropic.claude-v2'),
            'max_tokens' => env('CLAUDE_MAX_TOKENS', 6000),
            'region' => env('AWS_REGION', 'us-west-2'),
            'credentials' => [
                'key' => env('AWS_ACCESS_KEY_ID'),
                'secret' => env('AWS_SECRET_ACCESS_KEY'),
            ],
        ],
    ],

    'defaults' => [
        'temperature' => 0.7,
        'max_tokens' => 4000,
        'top_p' => 1.0,
    ],
];
```

💻 Usage
-------

[](#-usage)

### Basic Usage Example

[](#basic-usage-example)

You can use the package to interact with AI models as follows:

```
use Endritvs\LaravelAIToolkit\Models\Prompt;

$prompt = new Prompt();
$prompt->addContent('What is the capital of France?')
       ->setModel('gpt-4o-mini')
       ->setMaxTokens(50);

$response = $prompt->execute();

echo $response; // Output will be the AI's response.
```

### Explanation:

[](#explanation)

- addContent('What is the capital of France?'): Sets the question content for the AI model to process.
- setModel('gpt-4o-mini'): Specifies the AI model to be used.
- setMaxTokens(50): Limits the response to a maximum of 50 tokens.
- execute(): Sends the request to the AI model and retrieves the response.

### Query Builder Example

[](#query-builder-example)

The query builder allows you to build queries for AI models:

```
use Endritvs\LaravelAIToolkit\Models\Prompt;

$response = Prompt::query()
    ->setModel('anthropic.claude-v2')
    ->setMaxTokens(100)
    ->addContent('Tell me a joke')
    ->execute();

echo $response; // Output will be the AI's response.
```

### Explanation:

[](#explanation-1)

- Prompt::query(): Creates a new query using the AIQueryBuilder class.
- setModel('anthropic.claude-v2'): Sets the AI model to be used.
- setMaxTokens(100): Limits the response to a maximum of 100 tokens.
- addContent('Tell me a joke'): Adds content to the request.
- execute(): Executes the query and retrieves the result.

### Using Different Models Example

[](#using-different-models-example)

You can use different AI models for different tasks:

```
use Endritvs\LaravelAIToolkit\Models\Prompt;

// Using GPT model
$gptPrompt = new Prompt();
$gptPrompt->addContent('Explain quantum computing in simple terms.')
          ->setModel('gpt-4o-mini')
          ->setMaxTokens(150);

$gptResponse = $gptPrompt->execute();
echo 'GPT Response: ' . $gptResponse . PHP_EOL;

// Using Claude model
$claudePrompt = new Prompt();
$claudePrompt->addContent('What are the latest trends in web development?')
             ->setModel('anthropic.claude-v2')
             ->setMaxTokens(150);

$claudeResponse = $claudePrompt->execute();
echo 'Claude Response: ' . $claudeResponse . PHP_EOL;
```

### Explanation:

[](#explanation-2)

- Using GPT model:

    - addContent('Explain quantum computing in simple terms.'): Sets the content for GPT to explain.
    - setModel('gpt-4o-mini'): Specifies the GPT model to use.
    - setMaxTokens(150): Limits the response to 150 tokens.
    - execute(): Gets the response from GPT.
- Using Claude model:

    - addContent('What are the latest trends in web development?'): Sets the content for Claude to process.
    - setModel('anthropic.claude-v2'): Specifies the Claude model.
    - setMaxTokens(150): Limits the response to 150 tokens.
    - execute(): Gets the response from Claude.

### Using Fallback Providers Example

[](#using-fallback-providers-example)

Specify a fallback provider to use if the primary provider fails:

```
use Endritvs\LaravelAIToolkit\Models\Prompt;

$prompt = new Prompt();
$prompt->addContent('Summarize the latest news on AI technology.')
       ->setProvider('gpt')
       ->setModel('gpt-4o-mini')
       ->setMaxTokens(150)
       ->fallback('claude'); // Claude will be used if GPT fails

$response = $prompt->execute();

echo $response;
```

### Explanation:

[](#explanation-3)

- addContent('Summarize the latest news on AI technology.'): Sets the content for the request.
- setProvider('gpt'): Sets the primary provider to GPT.
- setModel('gpt-4o-mini'): Specifies the GPT model.
- setMaxTokens(150): Limits the response to 150 tokens.
- fallback('claude'): Configures Claude as the fallback provider if GPT fails.
- execute(): Executes the request, using the fallback provider if necessary.

### Set Provider Example

[](#set-provider-example)

Manually set a different provider for the AI model:

```
use Endritvs\LaravelAIToolkit\Models\Prompt;

$prompt = new Prompt();
$prompt->setProvider('claude') // Set a different provider
       ->addContent('Describe the principles of machine learning.')
       ->setModel('claude-v2')
       ->setMaxTokens(150);

$response = $prompt->execute();

echo $response; // The response from the specified provider.
```

### Explanation:

[](#explanation-4)

- setProvider('claude'): Manually sets the AI provider to Claude.
- addContent('Describe the principles of machine learning.'): Sets the content to be processed.
- setModel('claude-v2'): Specifies the Claude model.
- setMaxTokens(150): Limits the response to 150 tokens.
- execute(): Sends the request to the specified provider and retrieves the response.

### Advanced Query Builder Example

[](#advanced-query-builder-example)

Dynamically build and execute more complex queries:

```
use Endritvs\LaravelAIToolkit\Models\Prompt;

$response = Prompt::query()
    ->setModel('gpt-4o-mini')
    ->addContent('What are the implications of quantum computing?')
    ->setMaxTokens(200)
    ->execute();

echo $response; // Outputs the result based on the complex query.
```

### Explanation:

[](#explanation-5)

- setModel('gpt-4o-mini'): Sets the AI model to be used.
- addContent('What are the implications of quantum computing?'): Adds additional content to the request.
- setMaxTokens(200): Limits the response to 200 tokens.
- execute(): Executes the query and processes the response.

### Complete Example (Everything Included)

[](#complete-example-everything-included)

Combines all features into a comprehensive example, demonstrating both GPT and Claude models:

```
use Endritvs\LaravelAIToolkit\Models\Prompt;

// Example using GPT-4
$prompt = new Prompt();
$prompt->addContent('Give a summary of the latest advancements in technology.')
       ->setModel('gpt-4')
       ->setMaxTokens(300)
       ->fallback('claude'); // Fallback to Claude if GPT-4 fails

$response = $prompt->execute();

echo $response; // Outputs the result from GPT-4 or Claude if GPT-4 fails.

// Example using Claude
$claudePrompt = new Prompt();
$claudePrompt->addContent('Discuss the impact of recent technological innovations on society.')
             ->setModel('claude-v2')
             ->setMaxTokens(300);

$claudeResponse = $claudePrompt->execute();

echo 'Claude Response: ' . $claudeResponse . PHP_EOL;

// Example using Query Builder
$response = Prompt::query()
    ->setModel('gpt-4o-mini')
    ->addContent('What is the future of artificial intelligence?')
    ->setMaxTokens(150)
    ->execute();

echo $response; // Outputs the result based on the complex query and fallback.
```

### Explanation:

[](#explanation-6)

### GPT-4 Example:

[](#gpt-4-example)

- addContent('Give a summary of the latest advancements in technology.'): Sets the content for GPT-4.
- setModel('gpt-4'): Specifies GPT-4 as the primary model.
- setMaxTokens(300): Limits the response to 300 tokens.
- fallback('claude'): Uses Claude as the fallback provider if GPT-4 fails.
- execute(): Executes the request, retrieving the response from GPT-4 or Claude.

### Claude Example:

[](#claude-example)

- addContent('Discuss the impact of recent technological innovations on society.'): Sets the content for Claude.
- setModel('claude-v2'): Specifies Claude as the model.
- setMaxTokens(300): Limits the response to 300 tokens.
- execute(): Executes the request and retrieves the response from Claude.

### Query Builder Example:

[](#query-builder-example-1)

- Prompt::query(): Creates a new query builder instance.
- setModel('gpt-4o-mini'): Specifies GPT-4o-mini as the model for the query.
- addContent('What is the future of artificial intelligence?'): Adds additional content to the query.
- setMaxTokens(150): Limits the response to 150 tokens.
- execute(): Executes the query and retrieves the result based on the specified parameters.

🛠️ Contributing
---------------

[](#️-contributing)

Contributions are welcome! If you'd like to contribute to this package, please follow these steps:

1. Fork the repository.
2. Create a new branch (`git checkout -b feature/new-feature`).
3. Commit your changes (`git commit -m 'Add new feature'`).
4. Push to the branch (`git push origin feature/new-feature`).
5. Open a pull request.

🛡️ Security Vulnerabilities
---------------------------

[](#️-security-vulnerabilities)

If you discover a security vulnerability within this package, please send an email to \[\]. All security vulnerabilities will be promptly addressed.

📄 License
---------

[](#-license)

This package is licensed under the MIT License. See the [LICENSE](https://github.com/endritvs/laravel-ai-toolkit?tab=MIT-1-ov-file) file for more information.

💡 Tips & Tricks
-------------------

[](#-tips--tricks)

- Use environment-specific configuration to tweak AI model behavior depending on your deployment environment.
- Monitor the usage and response times of your AI models to optimize performance.
- Experiment with different AI models to find the one that best suits your application's needs.

📬 Support
---------

[](#-support)

If you have any questions or need further assistance, feel free to reach out via email or open an issue on GitHub.

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance37

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 95.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

614d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/16cf01bb1494c15d328ebff8624cccd7f83563c03e91eff04ea9a99d153874d7?d=identicon)[endritvs](/maintainers/endritvs)

---

Top Contributors

[![endritvs](https://avatars.githubusercontent.com/u/104865231?v=4)](https://github.com/endritvs "endritvs (22 commits)")[![Aluisio-Pires](https://avatars.githubusercontent.com/u/88967089?v=4)](https://github.com/Aluisio-Pires "Aluisio-Pires (1 commits)")

---

Tags

laravelawspackageaitoolkitgptartificial intelligence

### Embed Badge

![Health badge](/badges/endritvs-laravel-ai-toolkit/health.svg)

```
[![Health](https://phpackages.com/badges/endritvs-laravel-ai-toolkit/health.svg)](https://phpackages.com/packages/endritvs-laravel-ai-toolkit)
```

###  Alternatives

[bensampo/laravel-embed

Painless responsive embeds for videos, slideshows and more.

142146.8k](/packages/bensampo-laravel-embed)[mischasigtermans/laravel-altitude

Claude Code agents for the TALL stack, powered by Laravel Boost

1139.2k](/packages/mischasigtermans-laravel-altitude)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)