Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jpcaparas/laravel-faker-openai
A library that extends fakerphp and uses laravel/openai to generate fake data with prompts
https://github.com/jpcaparas/laravel-faker-openai
Last synced: about 10 hours ago
JSON representation
A library that extends fakerphp and uses laravel/openai to generate fake data with prompts
- Host: GitHub
- URL: https://github.com/jpcaparas/laravel-faker-openai
- Owner: jpcaparas
- Created: 2025-01-09T00:02:30.000Z (12 days ago)
- Default Branch: main
- Last Pushed: 2025-01-09T22:13:55.000Z (11 days ago)
- Last Synced: 2025-01-09T23:19:59.078Z (11 days ago)
- Language: PHP
- Size: 136 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Laravel Faker OpenAI Provider
A Laravel package that extends FakerPHP by adding an AI-powered data generator using OpenAI. This allows you to generate more realistic and context-aware fake data in your Laravel applications.
## Installation
Install the package via Composer:
```bash
composer require jpcaparas/laravel-faker-openai
```
The package will automatically register its service provider if you're using Laravel's package auto-discovery.
## Configuration
1. Make sure you have your OpenAI API key set in your `.env` file:
```env
OPENAI_API_KEY=your-api-key-here
```
2. The package uses `gpt-3.5-turbo` model by default.
## Usage
The package adds a new `promptAI()` method to the Faker generator. You can use it in several ways:
### Basic Usage
```php
$faker = app(\Faker\Generator::class);
// Generate a fake name using AI
$name = $faker->promptAI('name');
// Generate a movie review
$review = $faker->promptAI('movieReview');
// Generate a movie description
$description = $faker->promptAI('movieDescription');
```
... you can also use the built-in `fake()` helper:
```php
$name = fake('name');
```
### With Fallback Values
You can provide fallback values that will be used if the AI request fails:
```php
// String fallback
$name = $faker->promptAI('name', 'John Doe');
// Closure fallback
$name = $faker->promptAI('name', fn() => 'John Doe');
```
### Error Handling
By default, errors are logged and the fallback value is returned. You can make it throw exceptions instead:
```php
try {
$name = $faker->promptAI('name', null, true); // Set throwOnError to true
} catch (\Exception $e) {
// Handle the error
}
```
## How It Works
The package works by:
1. Intercepting FakerPHP method calls through a prompt
2. Sending them to OpenAI's GPT model
3. Returning AI-generated responses that match FakerPHP's expected output format
## Testing
Run the test suite:
```bash
composer test
```
## License
MIT