Stars: 165
Forks: 3
Pull Requests: 9
Issues: 1
Watchers: 3
Last Updated: 2023-02-19 21:47:32
An AI/ML toolbox for Laravel
License: MIT License
Languages: PHP
Dream is a package for Laravel that brings common AI/ML tools into your Laravel application without all the boilerplate.
It currently supports:
You can install the package via composer:
composer require christopherarter/dream
Next, publish the vendor config file:
php artisan vendor:publish --provider="Dream\DreamServiceProvider"
DREAM_OPENAI_API_KEY=your-api-key
To use AWS Comprehend, you can add your AWS credentials in your .env
file. Note: the user must have access to the AWS Comprehend service.
AWS_ACCESS_KEY_ID=your-access-key
AWS_SECRET_ACCESS_KEY=your-secret-key
To use this package, you can rely on the Dream
facade. This facade will automatically use the default driver you have set in your config/dream.php
file.
use Dream\Facades\Dream;
Sentiment analysis is the process of determining whether a piece of writing is positive, negative, or neutral. It's also known as opinion mining, deriving the opinion or attitude of a speaker. Dream includes several helper methods to make it easy to use sentiment analysis.
Example:
use Dream\Facades\Dream;
$sentiment = Dream::text('I love Laravel!')->sentiment();
$sentiment->disposition(); // 'positive';
$sentiment->positive(); // true;
Available Methods:
use Dream\Facades\Dream;
$sentiment->disposition(); // 'positive' | 'negative' | 'neutral';
$sentiment->positive(); // true | false;
$sentiment->negative(); // true | false;
$sentiment->neutral(); // true | false;
Entity extraction is the process of detecting and classifying key information from text and other unstructured data sources. It's also known as named entity recognition (NER).
use Dream\Facades\Dream;
$entities = Dream::text('I need a reservation for Mr. Foo and Mr. Bar at
the Foo Bar Restaurant on October 31st.')
->entities();
$entities->people()->toArray(); // ['Mr. Foo', 'Mr. Bar'];
$entities->places()->toArray(); // ['Foo Bar Restaurant'];
$entities->dates()->toArray(); // ['October 31st'];
Available Methods:
$entities->people(); // Collection of people
$entities->places(); // Collection of places
$entities->dates(); // Collection of dates
$entities->organizations(); // Collection of organizations
$entities->events(); // Collection of events
$entities->products(); // Collection of products
$entities->quantities(); // Collection of quantities
$enteties->other(); // Collection of other entities
Key phrase extraction is the process of identifying the most important phrases in a block of text. Dream includes the ability to extract key phrases from a string.
use Dream\Facades\Dream;
Dream::text('Laravel is a web application framework with expressive,
elegant syntax. We’ve already laid the foundation — freeing you to create
without sweating the small things.')
->phrases()
->pluck('text')
->toArray();
// [
// "Laravel",
// "a web application framework",
// "expressive, elegant syntax",
// "the foundation —",
// "the small things",
// ]
Language detection is the process of identifying the language of a given text. Dream includes the ability to detect the language of a string.
use Dream\Facades\Dream;
Dream::text('¿Cuál es tu película favorita?')->language(); // 'es'
The language code will be the ISO 639-1 code for the language. The
return type is a value backed enum Dream\Enums\Language
to ensure consistency
across clients.
Dream can detect the text inside of an image. To do this, we'll use the imageText()
method.
use Dream\Facades\Dream;
$file = Storage::get('image.jpg');
Dream::image($file)
->text()
->pluck('text')
->toArray();
// ["This was text in an image"]
Note: Currently only available using AWS
Dream can determine labels for an image using the imageLabels()
method.
use Dream\Facades\Dream;
$file = Storage::get('image.jpg');
Dream::image($file)
->labels()
->pluck('name')
->toArray();
// ["man", "fish", "boat", "water", "ocean", "sea"];
Note: Currently only available using AWS
The AWS user you provide will need to have access to the Comprehend service.
Here's a policy example:
{
"Version": "2012-10-17",
"Statement": [
{
"Action": [
"comprehend:*",
],
"Effect": "Allow",
"Resource": "*"
}
]
}
If you'd like to strictly adhere to least privilege, you can limit the Actions in the role
to just the ones you need. For example, if you only need to use the entities
method, you can limit the Actions to just comprehend:DetectEntities
.
To use the image detection methods, you'll need to enable the AWS Rekognition service for your user as well. You can add this to the example policy above:
{
"Version": "2012-10-17",
"Statement": [
{
"Action": [
"comprehend:*",
],
"Effect": "Allow",
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"rekognition:*"
],
"Resource": "*"
}
]
}
By default, Dream will use the AWS_ACCESS_KEY_ID
and AWS_SECRET_ACCESS_KEY
environment variables to authenticate with AWS Comprehend.
If you would like to specify a different AWS key & secret to use with Dream,
you can do so by setting the keys with the DREAM_
prefix.
For example,
DREAM_AWS_ACCESS_KEY_ID=your-key
DREAM_AWS_SECRET_ACCESS_KEY=your-secret
Coming soon :)
If you would like to build your own client, or contribute to this project by adding another client from a different provider, you can do so by extending the base classes:
Dream\Clients\Client
- The base client classDream\Clients\TextClient
- The base text client classDream\Clients\ImageClient
- The base image client classA client should have both image and text capabilities. These capabilities are handled in their own respective client classes.
<?php
use Dream\Clients\Client;
use Dream\Collections\TextEntityCollection;
use Illuminate\Support\Collection
class MyCustomClient extends Client
{
public function text(string $text): MyCustomTextClient
{
return new MyCustomTextClient($text);
}
public function image(string $image): MyCustomImageClient
{
return new MyCustomImageClient($image);
}
}
Next, you'll add your client to the config/dream.php
file.
<?php
return [
'connections' => [
// ...
'my-custom-client' => [
'driver' => MyCustomClient::class,
],
],
];
Finally, you'll set your client as the default driver in your environment. Here's an example in your .env
:
DREAM_DRIVER=my-custom-client
composer test
Please see CONTRIBUTING for details.
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
The MIT License (MIT). Please see License File for more information.